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MAGICSTORE USERS’ GUIDE 


PREFACE 

This book describes MacicSrore, a package of programs you can use to manage a multidimensional 
time series file. 

How to Get Help 


Your main source of information and assistance for MacicStore—and all I.P. Sharp products and 
services—is your I.P. Sharp representative. 


However, if you’re a member of the SHARP APL Message Processing Facility (MaILBox), you can 
also send questions or comments about MacicStore or this User’s Guide to the MacicSrorE query 
group, MQ. 


History 
MacicSrore is descended from Wizard 11. Wizarp 1 was developed in 1980 by Peter Airs and Nicola 


Coyne, both of I.P. Sharp’s London (England) office. Wizard 1 was developed by Airs and Coyne 
in 1980/81. MacicStore was developed by Airs in 1982 (as Wizard 1m), and is maintained by Airs. 


Copyright © 1983 by I.P. Sharp Associates Limited. 


All rights reserved. This book or parts thereof may not be reproduced by any means without the written 
permission of I.P. Sharp Associates Limited. 


Printed in Canada 
Publication Code: 0195 8303 E1 
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Chapter 1 


WHAT IS MAGICSTORE? 


MaaicStore is a simple, multidimensional file management system. You can use MacicSrore to 
create, maintain, list, and calculate with time series; that is, numeric data associated with regular 
periods, such as every day or every month. You can use MacicSrorz by itself, or with the 1.P. Sharp 
time series manipulation language Macic. MacicSrore is an excellent tool with which to create 
multidimensional files to be retrieved through Macic. 


You can use MacitcStore to create and update your own files. You can either enter data through 
a terminal keyboard, or extract data from another file, or from outside the SHARP APL system. You 
can create a file from data resident on the SHARP APL system, or from a magnetic tape from another 
computer system. Conversely, you can extract data under program control from a MacicSrore file, 
and subsequently list, manipulate, or merge it with data in other files. 


Users of MacicSrore anywhere in the world can access the same MacicStore file through the I.P. 
Sharp Network. The owner of a MacicSrore file controls who can share its data. 


Who Uses MacicStore? 


A user of MacicStore may be any user of SHARP APL: a user with no understanding of APL; 
or an experienced MacicStore user, with perhaps some APL knowledge as well. 


Chapters 5, 7, and 8 of this guide are for the more experienced APL user. These chapters are not 
essential to a basic understanding of MacicSrore and may be skipped by the novice. 


You can use MacicStore either conversationally or nonconversationally. 

+ When you use MacicSrore conversationally, you are guided through the system by a series of 
questions. These questions are called prompts. At each prompt, you can ask MacicStore to 
explain what you should enter. 

+ When you use MacicSrore nonconversationally, you manipulate the file with various APL func- 
tions, called commands. These commands set various states instead of asking questions. The 
nonconversational approach may suit you if you are an experienced MacicStore user. 


MacicStore has various input aids designed to streamline your dialogue with it. For instance, you 
can respond to several consecutive questions at once. There are also shorthand methods of entering 
repetitive strings of numbers, and abbreviated responses for all options prompted at the terminal. 


Using Other Time Series Products 


Data stored with MacicStore can be retrieved from any MacrcSrore file or any combination of 
MacicSroré files using the Maaic time series manipulation language. Using Macic, you can build 
customized reports, or calculate such things as moving average and least-square fit. You can also use 
Macic to timepack data from MacicSrore files; for example, to access a monthly MacicStore file 
in a quarterly, semiannual, or yearly format. 


Through Macic you can access several other I.P. Sharp application software products for time series: 


you can graph data with SvPERPLOT; or use Easy, an econometric analysis system. In addition, you 
can use your private MacicSrore file in conjunction with any I.P. Sharp public data base. 
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Where Is MacicStore? 


MacicStore can be accessed in workspace 39 MAGICSTORE. In this workspace, there are only three 

MacicStore functions—GETMAGICSTORE, ERASEMAGICSTORE, and LINK: 

* GETMAGICSTORE brings into the active workspace all the MacicStore programs you need. You 
can use GETMAGICSTORE in any workspace. 

+ ERASEMAGICSTORE expunges from the active workspace all MacicSrore functions and variables, 
except GETMAGICSTORE, LINK, and itself. 

+ LINK establishes a Macic access function for a MacicStorr. file. 


‘To use MacicSrore by itself, just load the workspace 39 MAGICSTORE: 


LOAD 39 MAGICSTORE 
SAVED 00.00.00 02/01/83 


When you load 39 MAGICSTORE, the function GETMAGICSTORE is automatically executed. 


‘Yo use MacicSrore with Macic, load any public Macic workspace, and then create a Macic access 
function with LINK: 


)LOAD 39 MAGIC 
SAVED 22.10.12 01/31/83 
LINK 'SALES' 
LINK is saved in every public Macie workspace. 
To copy the MacicSrore functions into the active workspace: 
)PCOPY 39 MAGICSTORE 
SAVED 00.00.00 02/01/83 
GETMAGICSTORE 
To remove all the MacicSrorr functions from the active workspace: 


ERASEMAGICSTORE 


ERA. 


WAG ICSTORE, GETMAGI 


TORE, and LINK remain. 
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Chapter 2 
A GLIMPSE OF MAGICSTORE 


This chapter is intended to introduce you to the capabilities of MacicStore without attempting to 
explain each step in detail. Every example but the last uses MacicStore in nonconversational mode. 


The MacicStore files we will be looking at contain data for an imaginary enterprise, the Frothy 
Beer Company PLC. The first file contains information on unit sales, by quarter, for each of Frothy 
Beer’s operating companies. The second contains the prices of the various types of beer sold by Frothy 
Beer. 


The Frothy Beer Company sells beer in five countries: UNITED STATES, UNITED KINGDOM, 
GERMANY, CANADA, and AUSTRALIA. The company brews various beer products: PALE ALE, 
LAGER, STOUT, and REAL ALE, which it sells in different packages: DRAUGHT, BOTTLES, and CANS. 
The two files, SALES and PRICES, contain information broken out by COUNTRY, PRODUCT, and 
PACKAGE. This information is tracked over time; in this example, by quarter. In other words, these 
files have four dimensions each: COUNTRY, PRODUCT, PACKAGE, and DATE. 


Each dimension is divided into attributes. For example, the COUNTRY dimension is divided into the 
five attributes: UNITED STATES, UNITED KINGDOM, GERMANY, CANADA, and AUSTRALIA. Each auri- 
bute has a label which is usually used in prompts and displays; and a code which you use to identify 
an attribute. 


Volumes are ostensibly given in thousands of hectolitres (hl). (A hectolitre is 22 Imperial gallons, or 
slightly more than 26 United States gallons.) However, the quantities are purely fanciful. 
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Here is a MacicSrore listing of sales in the first quarter of 1980, broken out by COUNTRY: 


FILE ‘SALES* 
PERIOD 1 80 
1 DATE SPECIFIED 
PAGES ‘DATE 
ROWS ‘PACKAGE ,PRODUCT* 
COLS ‘COUNTRY! 
ZERO 
LIST 


THE FROTHY BEER COMPANY PLC: QUARTERLY SALES 


DATE: 18ST QTR 1980 


| UNITED|  UNITED| | | | 
| STATES) KINGDOM| GERMANY) CANADA|AUSTRALIA| 


DRAUGHT 
PALE ALE 632 $1 145 11 7 
LAGER 0 o o o o 
STOUT 679 79 220 11 43 
REAL ALE o 8 0 1 0 
BOTTLES 
PALE ALE 233 19 65 77 3 
LAGER 0 18 0 0 (e 
STOUT 223 26 42 82 9 
REAL ALE 0 15 34 8 6 
CANS 
PALE ALE 245 67 25 21 1 
LAGER 0 183 0 o ie} 
STOUT 227 180 166 22 43 
REAL ALE 0 51 fo) 2 o 


Notice that the rows show sales broken out by PACKAGE and PRODUCT, while the columns show 
COUNTRY sales for one quarter. For instance, in the UNITED STATES, 242,000 hi of canned pale ale 
was sold in the first quarter of 1980. 


‘The figure on the next page is a schematic diagram of this listing. 
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THE FROTHY BEER COMPANY PLC: SALES 


COUNTRY 


PALE ALE 


LAGER 
PRODUCT 


DRAUGHT 


STOUT 


REAL ALE 


PALE ALE 4 


LAGER 4 


BOTTLES - PACKAGE, 


STOUT 4 


REAL ALE 4 


1ST QTR 1980 
2ND QTR 1980 
3RD QTR 1980 
uTH QTR 1980 


PALE ALE 
DATE 
LAGER 
STOUT 


REAL ALE 


1ST QTR 1980 
2ND QTR 1980 
3RD QTR 1980 
4TH QTR 1980 
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In the previous example, there are zeros in the listing where a certain PRODUCT is not sold in a certain 
PACKAGE and COUNTRY; these zeros need not be displayed, as shown in this listing: 


ROWS *DATE ,COUNTRY,PROD' 
COLS 'PACK' 

NOZERO 

LIST 


QTR 1980 
NITED STATES 


PALE ALE 632 239 245 
LAGER 
STOUT 679 223 227 
REAL ALI 
51 19 67 
18 183 
STOUT 79 26 180 
8 15 51 
145 65 25 
220 42 166 
34 
CANADA 
PALE ALE TA. 77 21 
LAG 
STOUT 11 82 22 
REAL ALE 1 8 2 
AUSTRALIA 
PALE ALE 7 3 1 


‘Uhis is the same information, except that the presentation has been changed. Here we have in the 
rows the DATE and COUNTRY broken down by PRODUCT; and in the columns only the type of 
PACKAGE. Notice that the names PRODUCT and PACKAGE in the MacicSrore commands that produced 
the listing have been shortened to PROD and PACK. Each of these names can be shortened to its shortest 
unambiguous truncation; that is, to as few characters as are necessary to distinguish it from the others. 
C, PR, PA, and D are the shortest representations possible of COUNTRY, PRODUCT, PACKAGE, and 
DATE. 
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The four MacicStore commands that generated this listing—-ROWS, COLS, NOZERO, and LIST—do 
not include PERIOD and FILE, as in the first example: once a file and periods have been selected, this 
state setting remains for all subsequent operations on the file until you give another PERIOD or 
FILE command. 


Here we have a listing of SAZES, including the total along the COUNTRY dimension: 


ROWS ‘DATE ,COUNTRY ,PRODUCT' 
COLS ‘PACKAGE! 

TOTAL 'COUNTRY' 

LIST 


15T QTR 1980 
UNITED STATES 


PALE ALE 632 239 245 
LAGER 
STOUT 679 223 227 
REAL ALE 
UNITED KINGDOM 
PALE ALE 51 19 67 
LAGER 18 183 
STOUT 79 26 180 
REAL ALE 8 15 $1 
GERMANY 
PALE ALE 145 65 25 
LAGER 
STOUT 220 42 166 
REAL ALE 34 
CANADA 
PALE ALE 11 77 21 
LAGER 
STOUT 11 82 22 
REAL ALE 1 8 2 
AUSTRALIA 
PALE ALE 7 3 t 
LAGER 
STOUT 43 9 43 
REAL ALE 6 
COUNTRY TOTAL 
PALE ALE 846 403 359 
LAGER 18 183 
STOUT 1032 382 638 
REAL ALE 3 63 53 
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Next we have a more condensed picture with just the total of ail countries and no detailed information 
by country; the state is similar to the previous examples, with PACKAGE still in the columns and 
COUNTRY and PRODUCT in the rows of the listing: 


NODETAIL ‘COUNTRY* 
LIST 


THE FROTHY BEER CO} 


COUNTRY :UNITED STATES UNITED KINGDOM,GERMANY ,CANADA, 
AUSTRALIA 


| DRAUGHT | BOTTLES | CANS | 
15T QTR 1980 
COUNTRY TOTAL 
PALE ALE 846 403 359 
LAGER 18 183 
STOUT 1032 382 638 
REAL ALE 9 63 53 


This next example shows average sales by COUNTRY and PRODUCT with no detailed information by 
COUNTRY: 


AVERAGE 'COUNTRY ,PRODUCT' 
LIST 


COUNTRY AVERAGE 


PALE ALE 169.20 80.60 71.80 
LAGER 18.00 183.00 
STOUT 206.40 76.40 127.60 
REAL ALE 4.50 15.75 26.50 
PRODUCT AVERAGE 157.25 57.73 94.85 
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Because 359,000 hl of canned pale ale was sold in five countries in the first quarter of 1980, an average 
of 71,800 hl per country is shown. The PRODUCT average figure for DRAUGHT, 157.25, is the average 
of the four nonzero values: the products not sold in draught aren't factored into the average. It is 
possible to display totals or averages for COUNTRY, PRODUCT, PACKAGE, or DATE. A total or average 
can be shown alongside the data or by itself. 


Now we take a look at another Frothy file, which contains prices. It differs from the SALES file in 
the number of decimal places stored with the data. The prices are ostensibly United States dollars per 
hectolitre; but, as with all examples in this guide, the values are quite fanciful. ‘The word “PAGE” 
indicates where MacicSrore will start a new page in the listing. 


FILE 'PRICES' 
PERIOD 1 80 2 80 
2 DATES SPECIFIED 
PAGES 'DATE' 
ROWS *PRODUCT' 


COLS ‘COUNTRY ,PACKAGE' 


LIST 


DATE: 1ST &TR 1380 


PALE ALE 
LAGER 
STOUT 
REAL ALE 


PALE ALE 74.53 
LAGER 

STOUT 76.53 
REAL ALE 


UNITED KINGDO. 


DRAUGHT | CANS 

100.72 73.45 80.65 84.19 

80.96 85.35 

94.90 100.98 76.86 81.87 87.08 
76.73 81.69 89.84 


85.31 88.38 85.78 92.28 110.54 
88.17 98.05 90.09 100.04 114.97 
91.80 95.44 102.53 118.31 
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PALE ALE 79.48 84.83 95.02 


LAGER 

STOUT 85.45 91.36 95.97 
REAL ALE 99.35 

PAGE 


THE FROTHY BEER COMPANY PLC 


DATE: 2ND QTR 1980 


PRICE: 


| UNITED STATES| UNITED KINGDOM 
| ------------------------------------------------- 2 es 
| DRAUGHT| BOTTLES| CANS| DRAUGHT| BOTTLES| CANS 
PALE ALE 89.75 93.86 104.19 69.28 78.90 86.56 
LAGER 82.24 84.30 
STOUT 92.98 94.73 111.72 73.69 80.64 93.57 
REAL ALE 82.44 85.54 91.82 


PALE ALE 75.51 82.27 89.83 87.15 100.74 108.53 
LAGER 

STOUT 81.52 89.32 96.08 96.86 106.77 112.40 
REAL ALE 89.59 96.17 112.94 118.12 
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| DRAUGHT| BOTTLES| CANS| 
PALE ALE 80.78 85.39 94.87 
LAGER 
STOUT 88.54 95.95 104.20 
REAL ALE 100.73 


The data from PRICES is printed with two decimal places, instead of none as in SALES. 


Returning to the SALES file, the following example shows the complete set of commands required to 
produce this listing. This example shows that you can change the order of the products and choose 
only CANS and BOTTLES from PACKAGE. This could be applied to all or any of the non-DATE di- 
mensions—PRODUCT, PACKAGE, or COUNTRY: 
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FILE 'SALES* 
PERIOD 1 80 
1 DATE SPECIFIED 
ROWS *DATE ,PRODUCT ,COUNTRY* 
COLS *PACKAGE' 
‘PRODUCT SET 'RA,LA,ST,PA' 
' PACKAGE’ SET 'C,Bt 
LIST 


1ST QTE 80 
REAL ALE 
UNITED STATE 
UNITED KINGDOM $1 15 
GERMANY 34 
CANADA 2 8 
4 ALIA 6 
KINGDOM 183 18 
GERMANY 
CANADA 
AUSTRALIA 
STOUT 
UNITED STATES 227 223 
UNITED KINGDOM 180 26 
GEPMANY 166 42 
CANADA 22 82 
AUSTRALIA 43 g 
PALE ALE 
UNITED STATES 245 239 
UNITED KINGDOM 67 19 
GERMANY 25 65 
CANADA 21 77 


Now we enter new data for the second quarter of 1982: 


FILE 'SALES* 
PERIOD 2 82 
1 DATE SPECIFIED 
ORDER ‘DATE ,PACKAGE ,COUNTRY ,PRODUCT' 
EDIT 
DATA ALREADY EXISTS ON FILE ... OVERWRITE (Y/N) ?: YES 
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PRODUCT-PALE ALE,LAGER,STOUT,REAL ALE 


DATE - 2ND QTR 1382 
PACKAGE- DRAUGHT 
COUNTRY- 


1. UNITED STATES : 828 0 805 0 
2. UNITED KINGDOM: 57 0 103 8 


3. GERMANY : 167 0 2320 
4. CANADA 2120121 
5. AUSTRALIA : 80 620 
PACKAGE- BOTTLES 

COUNTRY- 


6. UNITED STATES : 275 0 294 0 
7. UNITED KINGDOM: 26 23 35 16 


8. GERMANY : 87 0 52 43 
9. CANADA : 91 0 91 10 
10. AUSTRALIA > 40 116 
PACKAGE- CANS 

COUNTRY- 


11. UNITED STATES : 245 0 246 0 
12. UNITED KINGDOM: 82 220 197 52 


13. GERMANY : 27 0 209 0 
14. CANADA 26 0 28 3 
15. AUSTRALIA : 10450 


FILE UPDATED 


Here data is entered for four products for each of five countries, three package types. and one period 
When FILE was reissued, the dimension order was reset to its default; to change the presentation of 
prompts, ORDER had to be given again. The message DATA ALREADY EXISTS ON FILE indicates that 
some nonzero data on the file may be overwritten by this update. The first set of numbers entered 
begins with 828 for draught pale ale in the second quarter of 1982 in the Linited States, followed 
by 0 for draught lager, 805 for draught stout, and O for draught real ale. 


Now we enter DRAUGHT data for the fourth quarter of 1982, using attribute codes in the data prompts 


FILE 'SALES' 
PERIOD 4 82 
1 DATE SPECIFIED 
ORDER ‘DATE ,PACKAGE ,COUNTRY ,PRODUCT' 
SET 'Dt 
CODES 
EDIT 


PRODUCT-PA,LA,ST,RA 
DATE - 4TH QTR 1382 
PACKAGE- D 


COUNTRY- 
1. USA: 774 0 807 0 
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2. UK > 55 0 109 8 
3. GER: 157 0 234 0 
4. CAN: 14 0 13 1 
5. AUS: 7 0 54 0 


FILE UPDATED 


By default, labels (which may contain blanks) are used as prompts and as headings in data listings 
‘The CODES state setting function indicates that codes are to be used instead of labels for both headings 
and prompts. 


We now list the data just entered, but use the attribute labels: 


LABELS 
LISTDATA 


THE FROTHY BEER COMPANY PLC: SALES 


4TH QTR 1982 
UNITED STATES 


PALE ALE 774 
LAGER 
STOUT 807 
REAL ALE 
UNITED KINGDOM 
PALE ALE 55 
LAGER 
STOUT 109 
REAL ALE 8 
GERMANY 
PALE ALE 157 
LAGER 
STOUT 234 
REAL ALE 
CANADA 
PALE ALE 14 
LAGER 
STOUT 13 
REAL ALE 1 
AUSTRALIA 
PALE ALE 7 
LAGER 
STOUT Su 
REAL ALE 
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When you're modelling or validating data, you might find it convenient to express your calculations 
in terms of the file’s codes and dimension names. For example: 


FILE ‘SALES' 
PERIOD 1 82 
1 DATE SPECIFIED 
PAGES 'DATE,PACKAGE' 
ROWS ‘COUNTRY' 
COLS *PRODUCT! 
SET 'C' 
GETDATA 
‘EUR' IS SUM ‘'UK,GER* 
1NA' IS 'USA' PLUS ‘CAN* 
‘WORLD’ IS SUM 'EUR,NA,AUS' 
'EUR,NA' RELABEL ‘EUROPE ,NORTH AMERICA‘ 
LISTDATA 


BEER COMPANY PLC: QUARTERLY SALES 


UNITED STATES 242 279 
UNITED KINGDOM 84 199 183 52 
GERMANY 28 193 
CANADA 25 24 3 
AUSTRALIA 1 45 
EUROPE 112 199 376 52 


ORTH AMERICA 267 303 3 


New codes EUP, NA. and WORLD are defined in terms of COUNTRY codes. ‘These new pseudocodes are 
added to the COUNTRY dimension. 
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Before we could add or list data from the Frothy Beer Company's files. the files had 10 be 
created, This is answering a set of questions. These are the prompts and answers to them 


when the S. 7 file was created: 


PILE: SALES 
PILE 'SALRS' CREATED 


SPECIFY DATABASE FREQUENCY AND TITLE 


QUENCY ( An MILs S/¥/G/0) :QUARTERLY 


S AND CODES 


MENSIONS EXCEPT TIME: 3 


1) :COUNTRY , PRODUCT , PACKAGE 
1 


C; 


735 


FOR-PACKAGE :3 
D,B,C 


R Y TO CONTINUE, N 


MAX NO. OF DECIMAL PLACES $10. 
SPECIFY PIL, “ATION 

NUMBER OF C - 54 3 
WILL MORE CO : NO 
PARTITION DIME: ‘Al E): DATE 


NO. OF DATE/BLOCKS 
NEW DATABASE ‘SAL 


116.67) ox (Y/N)? : YES 


ao AG 
Ài 


& ( 
ATED 


MactcSvore validates what vou enter at most prompts. For example. MacicSrorr checks that you 
enter numeric information when MacicSrorn expects such data. MacicSvorr also performs other 

es, such as making sure your file codes are unique, and that the number of codes entered is correct 
You can also return to the previous prompt to correct a mistake by typing STOP. 
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When a MacicSrore file is created, the labels are the same as the codes. If you want to change the 
labels you use the CL suboption of the ALTER option. This is how the labels for the SALES file were 
entered 


WIZARD 
OPTION: ALTER 
* ALTER 


FILE: SALES 
ALTER OPTION:CL 

* CHANGE LABELS 
DIMENSION(S): ALL 


DIMENSION -COUNTRY 
PRINT LABLES (Y/N):NO 


CHANGE LABELS: ALL 
USA:UNITED STATES 
UK :UNITED KINGDOM 
GER:GERMANY 

CAN :CANADA 

AUS: AUSTRALIA 


DIMENSION -PRODUCT 
PRINT LABLES (Y/N) :NO 


CHANGE LABELS: ALL 
PA :PALE ALE 


RA :REAL ALE 


DIMENSION -PACKAGE 
PRINT LABLES (Y/N) :NO 


CHANGE LABELS: ALL 


D ;DRAUGHT 
B :BOTTLES 
C CANS 


LABEL(S) CHANGED 
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Chapter 3 


BASIC CONCEPTS AND FEATURES 
——— ee 


TERMS 


In the Frothy Beer Company's SALES file, each data value corresponds to a single COUNTRY, 
PRODUCT, PACKAGE, and DATE. These are the dimensions of the data and therefore of the file. 
DATE is a dimension because the data comes in quarterly periods. The DATE dimension is present in 
all MacicStors files. 


A dimension is always divided into various attributes. In our example, COUNTRY is divided into 
UNITED STATES, UNITED KINGDOM, GERMANY, CANADA, and AUSTRALIA. These COUNTRY attributes 
are identified with codes and labels. In our example, the dimensions and attributes, and their labels 
and codes look like this: 


Dimension Attribute 
Label Code Index 
1 COUNTRY 1 UNITED STATES USA T 
2 UNITED KINGDOM UK 2 
3 GERMANY GER 3 
4 CANADA CAN 4 
5 AUSTRALIA AU 5 
2 PRODUCT 1 PALE ALE PA 1 
2 LAGER LA 2 
3 STOUT ST 3 
4 REAL ALE RA 4 
3 PACKAGE 1 DRAUGHT D 1 
2 BOTTLES B 2 
3 CANS (a 3 
4 DATE 1ST QTR 1980 1 80 


You enter DATE labels only for files set up with frequency OTHER. DATE labels for frequencies 
DAILY, WEEKLY, MONTHLY, QUARTERLY, SEMI, YEARLY, and GENERAL are all generated automatically 
when you select periods for editing or listing data. Labels are used when data is listed, and as prompts 
when data is entered. You can use codes instead of labels for prompts and listings using the state 
setting function CODES, and can return to labels using the function LABELS. In MacicStTorr, you 
use codes for retrieving data through Macic, and to select attributes with MacicStore’s SET command. 


A MacicStore file is a set of numeric data for a particular set of dimensions. One of this guide’s 
sample files tracks quantities of beer sold. Beer prices form another file. Alternately, quantity and price 
could be established as two attributes of a new dimension. Each file comprises data of only a single 
frequency. For example, the data frequency must be all yearly or all quarterly. You cannot mix yearly 
and quarterly data in the same file, but you can have two very similar files, one having yearly data, 
the other quarterly. 


The following example shows how a file can be sliced arbitrarily to reach a single value. The diagram 
on the next page illustrates this slicing. 
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FILE 'SALES* a SELECT INFORMATION ON SALES 

a SELECT A PERIOD (THE FOURTH QUARTER 
PERIOD 4 82 A OF 1982) 
CIFIED 
'COUNTRY' SET 'GER' 


1 DATE 


SELECT THE <GERMANY> PLANE FROM THE 
<COUNTRY> DIMENSION 
SELECT THE <PALE ALE> PLANE FROM THE 
<PRODUCT> DIMENSION 
SELECT THE <BOTTLES> PLANE FROM THE 
<PACKAGE> DIMENSION 


"PRODUCT! SET 'PA' 


‘'PACKAGE' SET 'B' 


a 
A 
A 
a 
A 
A 


LIST 


THE FROTHY 


LTH QTR 1982 
GERMANY 


Since a MacicSrore file can have many dimensions, each with various attributes, you must be able 
to specify the order in which these dimensions and attributes are to be displayed or entered. T'he 
examples in “A Glimpse of MacicSrore” show several ways in which the sales data can be presented. 
When printing the data you must specify what order the dimensions are to appear in the pages, 
rows, and columns of a listing. 


When displaying data, you may not always wish to display every attribute of a dimension. For instance, 
you may wish to display sales data for only UNITED STATES and UNITED KINGDOM: you must 
therefore set which attributes of the COUNTRY dimension you want and in what sequence they are to 
appear. 


A period in MacicSrorr is a single unit of time—that is, an attribute of the DATE dimension. ft 
can be a day. week, month, quarter, half year, year, or some special fraction of a year. A file's 
frequency is fixed; it cannot be altered once data is stored on that file. The same set of periods is stored 
for all attributes. 
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20 


THE FROTHY BEER COMPANY PLC: SALES 


4TH QTR 1982 


PACKAGE 


PRODUCT 


a a D A 
COUNTRY 


GERMANY PALE ALE BOTTLES 
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FEATURES 


Handling Large Amounts of Data 


With MaatcSvorr, you have considerable flexibility as to how your file is structured. You can optimize 
retrieval or updating, depending on which is more important to your application. To minimize file 
storage costs for files that contain large amounts of blank (zero) data, MacicSrore uses a sparse 
data storage method. Also, MacicSrore has been designed to be easily modified to suit particular 
requirements, such as data validation. consolidation, and offline printing of large volumes of data. 


Creating a large file requires some careful thought about how data is to be stored. It is not in the 
scope of this guide to address all conceivable file design considerations; however, the most common ones 
are discussed, especially in the chapter on “File Design”. If, after reading this guide, you are still 
uncertain how best to optimize updating or retrieval for your file, you should consult your 1.P. Sharp 
representative. 


Error Messages 


Vhroughout the MacicSror® system, there are helpful messages which inform you if you have entered 
something which MactcSrore detects as incorrect. For example, if the name of the file is incorrect 
or if it doesn’t exist, you are informed that the file you’ve specified is not a MacicSrore file. When 
you select an option that does not exist, an error message is displayed and you are reprompted for 
the option. MacicSvore lists the options if you enter HELP at the prompt. When you enter a set of 
numbers to update a file, MacicSrore will inform you if you have entered the incorrect number of 
values and how many values you should be entering. 


Using MacicStorr on a Non-APL Terminal 


All the examples in this User's Guide show MacicSrore on a terminal with the APL character set 
You can. however, use MacicSrore on a terminal not equipped with this character set. For more 
information about this, see Using the LP. Sharp System: A Handbook for Nonprogrammers. 


Controlling the Current Input Line for Data Entry 


When you update or amend data in a MacicSvore file, you can skip various lines of input or jump 
back to some previons input line to correct an error. The prompts printed at the terminal requesting 
data to update the file look like: 


4 UNITED STATES: +30 

where the first number indicates the current input line, that is, line 24. 1f you want to jump to another 
line, either before or after the current line. you may use the right arrow, + . For example, enter 
+20 to jump back to line 20; or +30 to jump forward to line 30. 


Shorthand Notations for Input 


‘There are two shorthand methods for entering numbers: 

* Ata prompt where WIZARD expects numbers, such as when you're editing a file, you can use any 
SHARP APL expression that has a numeric result. This includes, for example, your own API 
wility functions. For more information, see “Data Entry Aids”. 
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+ At option selection prompts (such as for ORDER, PAGES, ROWS, TOTAL, or SET), you can select a 
range of options using a hyphen. For example, if MacicSrorr expects six numbers at a prompt: 
5-6,10 15 is equivalent to 5 6 7 8 10 15 
6 4 6,10-12 is equivalent to 6 8 10 11 12 
5,6-8 is equivalent t0 3 4 5 78 


Oe 


Remote Printing of Reports 


You can have reports printed at your terminal or at a printer in an ILP. Sharp office (using the 
HSPRINT lacility). Using HSPRINT is substantially less expensive than printing at a terminal. so you 
should use it for printing long reports that you don’t need right away, FSPRINT output can be mailed 
to you. or collected by a courier. 


Multi-User Access to MacicSrore Files 


You can share any MacicSrorr file you own with other MacicSrorr users. Thi 
your control, and you can withdraw another user's access at any time. 


sharing is under 


You should store in a single file only that data for which the shared access is to be the same. You 
can use WIZARD’s ACCESS option to control access to your MacicSrore. files. (For more precise or 
specialized access control. you can use system function [SPAC.) 


You can log when and by whom a particular MacicSrore file is selected. For more information, see 
“Logging Use of MacicSrore Files 


Restarting MAGICSTORF. 


If you are disconnected from SHARP API, the active workspace is saved with the name 
CONTINUE: this workspace is automatically reloaded the next time you sign on. If you were using 
conversational MacicSvorE when you were disconnected, the program should resume exactly where 
you were when you were disconnected. If you were using nonconversational MacicSrore when you 
were disconnected, enter: 


>RESTART 


MacicSrore Profile 


You can use the SHARP APL Workspace Profile Facility to set up a profile for workspace 
33 MAGICST A workspace’s profile is a program that is automatically executed when you load 
the workspace MAGICSTOPE contains a simple default profile. 


Set a MacicStore profile when you find yourself setting the same state options nearly every time you 
load MAGICSTORE, or when you want an ASK macro file tied when you load the workspace. 


You use the SEPPROPILE function from workspace 777 PROFILE to set and reset a profile. A 


workspace profile may comprise any number of functions and variables, all of which vou specify in 
a namelist argument to SETPROFILE. The profile need not include any functions or even any objects 


33 MAGICSTORE’s default profile executes the GETMAGICSTORE program. 
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To set or reset a profile: 


1 Make sure your active workspace is the one you want to set a profile for. 
2 Copy SETPROFILE into the active workspace. 

3 Redefine or define the objects that are to form the profile. 

4 Reset the profile. 


Example. The user resets his MAGICSTORE profile. His profile includes only a redefined PROFILE 
function: 


\WSID 
IS 39 MAGICSTORE 
OLX 
GETPROPILE 


ORE 


)PCOPY 777 PROFILE SETPROFILE 
SAVED 16.54.09 04/23/82 
VPROFILE(O] 


[2] FILE 'SALES' a SELECT MOST-USED FILE 
ESI ASK[11]«998 a MACRO FILE TIE NUMBER 
(4] 9 

SETPROFILE 'PROFILE' 
PROFILES RESET 
SPECIFYING INFORMATION TO MAGICSTORE 
Blanks 


MacicStorm removes leading blanks from input. For example: 


SALES 


and 


FILE * SALES! 
are treated by MacicSrorr as specifying the five-character file name 'SALES?. 
MacicSrore also compresses unnecessary embedded blanks. For example, MacicSrorr changes 
ROWS ‘COUNTRY, PRODUCT, PACKAGE' to ROWS ‘COUNTRY „PRODUCT ,PACKAGE?. 
Shortest Unambiguous Truncation 
When MacicSrorr expects you to specify an item from a restricted list of items, you usually needn't 


enter the item’s whole name: you need enter only so much of the item’s name as is necessary to identify 
the item uniquely. Such an entry is called the shortest unambiguous truncation. 
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ample, let's say you're called on to specify a file dimension. In the Frothy Beer Company's 
file (used throughout this guide), there are four dimensions: 


COUNTRY 
PRODUCT 
PACKAGE 
DATE 


‘To specily COUNTRY and PRODUCT, you need enter only C and PR: 


SET WHICH DIMENSIONS: C,PR 


Or, as left arguments to the SET command: 


'PR' SET 'LA' 
'C' SET 'USA' 


Specifying Periods 


You have to select periods before you can do most MacicSrore operations—in particular, before you 
can edit, list, get, or put data. You can select: 

> a single period: 

o a range of periods—that is. a timeframe; or 

o an arbitrary group of periods. 


The periods you specify must be consistent with the file’s frequency; for example, if your fite’s 
Irequeney is MONTHLY, vou must specify months. 


This is how you specify a period for cach frequency MacicStorr allows: 


Period 

Frequency specification 
DAILY dd mm yyyy 
WEEKLY dd mm yyyy 

mm yyyy 

a yyyy 

h yyyy 

yyyy 
OTHER n 
GENERAL PP yyyy 


‘The elements of a period specification (for example, mm and yyyy) are always separated by blanks. 
You can omit the century part of the year; for example, 82 and 1982 are equivalent. 

OTHER periods are completely arbitrary groupings of data, with numbers such as 1, 2. 3, 9999, ete. 
Labels lor OTHER periods are defined using the AP suboption of WIZARD’s ALTER option. 

GENERAL periods break years into an arbitrary number of periods, defined when the file is created: 
for example. 13 four-week periods. or 26 fortnights. 
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Specifying your selection of periods. MacicStore lets you select a single period, a range of periods 
{sometimes called a timeframe), or an arbitrarily sequenced group of periods. This is how you specify 
each such selection: 


Type of selection Specification 

A single period period 

A range of periods periodi TO period2 

An arbitrary group of periods period] period2 ... periodn 


If you select an arbitrary group of perieds, you can separate the individual period specifications with 
commas, but this isn’t necessary. (In fact, MacrcStore replaces all commas with blanks.) 


periodl period2 ... periodn,startperiod TO endperiod 


periodl TO period2,period3 TO period4 
periodl TỌ period2,period3 ... periodn. 


Examples 
+For a file with DAILY data: 


25 12 79 
specifies December 25, 1979. 


1 1 80 TO 1 3 80 
specifies January 1 through March 1, 1980. 


1 1 1980 TO 31 12 1980 
specifies every day in 1980. 


*For a file with WEEKLY data: 


25 12 79 
specifies the week of December 25, 1979. 


41 80 TO 1 3 80 
specifies January 1 through March 1, 1980. 


1 1 1980 TO 31 12 1980 
specifies every week in 1980. 


¢For a file with MONTHLY data: 


1 80 TO 12 80 
specifies all months in 1980. 


10 80 11 80 12 80 1 81 
specifies October 1980 through January 1981. 


1 1980 2 1980 
specifies January and February 1980. 
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1 80 2 80 3 80 4 80 
specifies January through April 1980. 


1 1980 2 1980,1 1981 TO 4 1981 
specifies January and February 1980, and January through April 1981. 


*For a file with QUARTERLY data: 


1 1980 2 1980 
specifies the first two quarters of 1980. 


ł 80 2 80 3 80 4 80 
specifies all four quarters of 1980. 


1 1980 2 1980,1 1981 TO 4 1981 
specifies the first two quarters of 1980, and all four quarters of 1981. 


«For a file with SEMI (that is, half-yearly) data: 


1 1980 2 1980 
specifies both halves of 1980. 


*For a file with YEARLY data: 


75 76 77 78 80 82 84 
specifies 1975 through 1978, and 1980, 1982, and 1984. 


1980 TO 1983,1986 TO 1990 
specifies 1980 through 1983, and 1986 through 1990—nine years altogether. 


«For a file whose frequency is GENERAL: 


1 80 TO 12 80 
specifies the first 12 periods of 1980. 


10 80 11 80 12 80 1 81 
specifies the 10th, 11th, and 12th periods of 1980 and the 1st period of 1981. 


1 1980 2 1980 
specifies the first two periods of 1980. 


1 80 2 80 3 80 4 80 
specifies the first four periods of 1980. 


1 1980 2 1980,1 1981 TO 4 1981 
specifies the first and second periods of 1980 and the first four periods of 1981. 


1 81 TO 13 81 
specifies the first 13 periods of 1981. 


*For a file whose frequency is OTHER: 


1705 
specifies the first five periods. 
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Specifying Dimensions 


Specify a dimension by its dimension name or its dimension number. A file’s dimension names are 
defined when the file is created or altered—except DATE. (The DATE dimension exists in every 
MacicSrorr file, and is always called DATE when the file is created. You can use the CD suboption 
of ALTER to rename the DATE dimension.) A file’s dimension numbers are determined by the order 
in which the dimensions were defined—except DATE, which is always the last dimension. 


If vou specify dimensions by name, you need only enter the shortest unambiguous truncation of the 
name, lor example, C for COUNTRY, or PR for PRODUCT. If you enter more than one dimension name, 
you have to separate them by commas. For example: 


SET WHICH DIMENSIONS: PRODUCT ,PACKAGE 


or 


ORDER ‘PRODUCT ,PACKAGE* 


If you specify more than one dimension by number, you have to separate the numbers by blanks or 
commas. For example: 


SET WHICH DIMENSIONS: 2 3 


or 


ORDER 2 3 


Specifying Attributes 


You can specify an attribute by its code, its label, or its attribute number. A file’s codes are defined 
when the file is created or altered. Labels are the same as codes unless altered. A dimension’s attribute 
numbers are determined by the order in which the attributes were defined. 


Significant Data 


MacicSrore includes significant data in the calculation of totals and averages; and, if AMEND is set, 
displays significant data before it is overwritten. In all cases, MacicSrore treats all nonzero data as 
icant. Whether MacicSrore treats zeros as significant is determined by which of ZERO and 
OZERC is the default state, and causes zero data to be treated as nonsignificant. If 
MRE to treat zero as significant, set ZERO. 


you want Ma 
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Chapter 4 


CONVERSATIONAL MAGICSTORE 


Alter you get or load MacicSrore, you can start conversational MacicSrore by typing: 
WIZARD 

WIZARD prompts you to select an option: 

OPTION: 

Select one of these: 

Set access to a MacicSrore file 

Change a file's parameters 


Amend or add data to a file 
Create and set up a file 


DELETE Delete periods from a file 
IRECTORY Display information about a file 
ERASE Erase a file 


E Select a file 
ST List data from a file 
UPDATE Add or change data in a file 


You need enter only the shortest unambiguous truncation to identify an option. For example, you 
need only type Z to select the LIST option. If you reply with an ambiguous string, such as A, 
WIZARD will respond with: 

<A> AMBIGUOUS WITH ALTER, ACCESS, AMEND 

In this event, you must enter at least two characters—specifically, AC, AL, or AM—to specify the option 
uniquely. 

THE Asx SUBPROGRAM 

The WIZARD program prompts for and handles terminal input through its ASX subprogram. ASK gives 
you a great deal of control over your input to WIZARD. ASK’s behaviour is governed by its state. 
ASK Commands 


Whenever WIZARD prompts you for any kind of input, you can enter an ASK command, which is dealt 
with by the ASK subprogram. The ASK commands are: 
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) 


indicates that you want to use macroinput. For more information, see “Macroinput”, below. 


indicates that you want to display or reset the ASK state. For more information, see “The ASK 
Subprogram State”, below. 


? or HELP 
displays a message at the terminal that gives you more information on what you should enter. When 
WIZARD is prompting you for numeric input, HELP tells you how many numbers are required with 
how many decimal places. When WIZARD is prompting you to select an option, HELP gives you 
a full list of the options and their meanings. There is often more than one HELP message: the first 
HELP message is fairly short; subsequent ones may be more extensive. Type HELP after the system 
has printed a HELP message, if you want to print the next HELP message. If WIZARD responds 
NG FURTHER HELP AVAILABLE, you have displayed all the HELP messages for this prompt. At this 
point (if not before), you should consult this guide. 


o 
puts you into SHARP APL’s evaluated-input mode. You can enter any SHARP APL expression; 
if it has a result, WIZARD will try to use it. You can also use [J to pause within WIZARD to enter 
a SHARP APL system command such as )COPY. 


forces the current prompt to be issued again. You'd use this in buffered or macroinput to ask for 
user input in the middle of a buffered sequence. 


2 
executes what is to the right. For example: 


)PCOPY MYMSUTIL DIMNAMES 
48.22 03/27/84 
(1) : aDIMNAMES 


EXIT or QUIP 
gets you out of the current WIZ. 
ignore all the numbers you hi 


D option. If you use EXIT during data entry, MacicSvore will 
e entered so far and will not issue the message FILE UPDATED. 
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STOP 
returns you to the previous prompt, or takes you out of this level of WIZARD. For example, when 
you want to list data using the WIZARD function, you are prompted for OPTJON, FILE, and then 
PERIOD. Typing STOP at PERIOD takes you back to the prompt FILE; typing STOP at PILE returns 
you to OPTION. Typing STOP at OPTION takes you out of WIZARD 
to a previous prompt. ‘lo exit completely from WIZARD, use EXIT. 


Buffered Input 


WIZARD allows you to “answer ahead” if you know exactly what prompts are next. This is called 
buffered input. For example, if you want to list 1980 Frothy sales data, you answer WZARD's prompts 
thus: 


OPTION: LIST 
PILE:SALES 
PERIOD:1 80 TO 4 80 


But you could enter this same set of answers all at once, at the first prompt. thus: 


OPTION :LIST;SALES;1 80 TO 4 80 


(The FILE and PERIOD prompts are consequently bypassed.) The responses are separated by semico- 
lons (or by the current value of *SEPARATOR; see below). If you make a mistake in one of the 
responses, WIZARD issues its usual error message. All subsequent buffered responses are ignored, if 
the *CLEAR state is set; this is the default setting. 


You can disallow buffered input, or change how it works by changing the ASX subprogram state. This 
is discussed below. 

Macroinput 

You can define a macro to WIZARD for a single or buffered response you often give WIZARD. A macro 
is identified by its mame, which may be any valid SHARP APL variable name. A macro's 
contents may be anything that you'd enter in response to WIZARD prompts; these responses may be 
simple or buffered. Buffered replies should be separated by semicolons (or by the current value of 


* SEPARATOR; sec below). 


To define or redefine a macro, enter a right parenthesis, the macro’s name, a colon, and the macro's 
contents: 


OPTION: )PRINT8®1:LIST;SALES;1 81 TO 4 81 

‘To use a macro, enter a right parenthesis and the macro’s name: 
OPTION: )PRINT81 

* LIST 

SET/PAGE/ROWS/COLS/TOP/AVE/NOD: 


Vo list all macros available: 


OPTION :? 
MACROS ARE....)PRINT81,)PRINTS2 
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To list the contents of one macro: 


OPTION: )?PRINT81 
)PRINT81 LIST,;SALES;1 81 TO 4 81 


To delete a macro, just redefine it empty: 
OPTION: )PRINTS81: 


Each macro is a character vector packed into ASKMAC. To save macros, you have to save ASKMAC; one 
way to do this is to save the workspace: 


)WSID 
IS 39 MAGICSTORE 

)SAVE MYMAGICSTORE 
SAVED 23.17.17 04/18/83 


Another way to save macros is to have a macro file called ASKMACRO. To set up such a file, execute 
MaGicSrorE’s CREATEMACROFILE program. Then define ASK[11] (element 11 of the ASK subpro- 
gram’s state vector) to the tie number of this file. Then either save the workspace (as above), or define 
your MacıcSrorr function to define ASX[11] (profiles are discussed in “MAGICSTORE Profiles”). 


If ASK[11] isn’t zero when you execute the WIZARD program, WIZARD tries to share-tie a file called 
ASKMACEO in your library to the indicated tie number. Then, whenever you define or redefine a macro, 
this new definition is inserted into ASKMAC and replaced in component 2 of file ASKMACRO. 


The ASK Subprogram State 


‘The ASK subprogram state governs how ASK works. To list the current ASK state, just enter * ‘aster- 
isk’ in response to any prompt. This, for example, shows the default ASK state: 


OPTION: * 

*BUFFER  *CLEAR *MACRO *NOEMPTY 
*SEPARATOR ';' 

*SUPFIX a 

+0 MODE xe MODE +O] 


‘Yo allow buffered input and macroinput, enter *BUFFER (this is the default). To disallow buffered 
input and macroinput, enter *VOBUFFER. 


‘To allow macroinput to be defined or used, enter *4ACRO (this is the default). Vo disallow macroinput, 
enter *VOMACRO. 


To have the input buffer cleared when any error is found in any part of the input, enter *CLEAR 
(this is the default). To have the buffer kept, enter *VOCLEAR. 


To allow empty replies (which are often meaningful), enter «EMPTY. To disallow empty replies, enter 
*NOEMPTY (this is the default). Some prompts allow empty replies regardless. 


‘Vo reset the character taken to separate replies in buffered input. enter «SEPARATOR 'sep', where 
sep is the character you want. The default separator is *;', but you can have another separator, or 
several separators, or no separator. For example: 
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OPTION: *SEPARATOR '0;' 


To reset the characters that are suffixed to prompts, enter *SUFFIX ‘suffix'. Within suffix, you can 
use L to represent LINEFEED, B to represent BACKSPACE, or C for RETURN. The default suffix is ''. For 
example: 


OPTION: *SUFFIX ' L' 

‘This causes MacicSrore to space down one line after each prompt. Although this uses quite a lot 
of paper, it can be convenient if your hardcopy terminal obscures the prompt on the current line. 
CREATING A FILE: THE CREATE OPTION 

Select the CREATE option to create and set up a MacicSrore file: 

* CREATE 

When vou select CREATE, WIZARD prompts you to identify the file that is to be created: 

PILE: SALES 

Enter a well formed SHARP APL file name. [Such a name must comprise | to 11 characters, without 
embedded blanks; the first character must be alphabetic (A to Z, 4 to Z, A, or A); the remaining 
characters may be alphabetic or numeric (0 to 9). You can prefix to the name your current signon 


number. | 


If you have entered a well formed file name but this file already exists in your file library, an error 
message is printed, and you are reprompted for the file name. If all is well. WIZARD prints: 


CREATED 


WIZARD then creates the file, and there is a slight delay while WIZARD appends directory components 
to it 


'ZARD now prompts you through lour sections to specify the file’s parameters. 


CY AND TITLE 
MES AND CODES 
E SCALE FACTOR 


At the end of the four see meters of your file will have been specified and a message 
such as MEW DATAR, a ‘ATED will be printed. 

Specifying a File’s Frequency and Title 

SPECIFY PILE FREQUENCY AND TITLE 

WIZARD prompts you lor the file's frequency: 


FREQUENCY: QUARTERLY 
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Enter the file’s frequency; it must be one of: 

DAILY 

WEEKLY 

MONTHLY 

QUARTERLY 

SEMI 

YEARLY 

OTHER 

GENERAL 
+If you reply DAILY, WIZARD then prompts you for which days of the week: 
DAYS OF WEEK: MON ,TUE ,WED,THU ,PRI 
Enter the days; for all days, enter ALL. 


If you reply WEEKLY to FREQUENCY, then WIZARD prompts you to specify the day of the week on 
which the periods start: 


DAY OF WEEK: PRI 


Enter the day. For example, if your data refers to the Friday closing price of securities, enter FRI 
at this prompt—even if you enter the data on Saturday. 


elf you specify a GENERAL frequency, you are prompted for the number of data periods per year. 
PREQUENCY: 13 


Enter a number between 1 and 99. For example, if you have data reported every two weeks, enter 
26. 


WIZARD then prompts you for the file's tide: 
REPORT TITLE: SALES OF BEER FOR FROTHY BEER COMPANY 


Enter any number of characters, including embedded blanks. A file’s title heads all listings of the data. 


Specifying a File’s Dimensions and Attributes 

SPECIFY DIMENSION NAMES AND CODES 

WIZARD prompts you for the number of non-DATE dimensions the file is 16 have: 
NO. OF DIMENSIONS EXCEPT TIME: 3 


For example, if data is COUNTRY by PRODUCT by PACKAGE by DATE (as in the Frothy Beer examples). 
then enter 3; if data is PRODUCT by DATE, enter 1. 


WIZARD then prompts you for the names of the dimensions: 


DIMENSION (1) :COUNTRY,PRODUCT , PACKAGE 
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Enter the names of the dimensions, separated by commas. If you enter only one dimension name. 
WIZARD prompts you for the others in turn; for example: DIMENSION (2). The order in which you 
define dimensions is meaningful: it becomes the default order in which MacicSrorr will forever 
present the dimensions. 


WIZARD then prompts you for the number of codes—that is, attributes—the first dimension is to have: 


This, in effect. specifies the number of attributes in this dimension. For example, if you have five 
countries—the United States, the United Kingdom, Germany, Canada, and Australia—enter 5 at this 
prompt. 


WIZARD then prompts you for all the codes in the first dimension: 


CODE’ (1) : USA 
CODE. (2) : UK 

CODE. (3) : GER 
CODE1 (4) : CAN 
CODE1 (5) : AUS 


A code is one way you and MacicSrore specify an attribute to each other. Codes are used as attribute 
names for Maaic access functions, and as arguments to Maci:Store’s SET command. By default, the 
labels for the file are the same as the codes entered. ‘The labels appear in MacicSrorr listings of 
the data, and are the automatic labels on Macic reports and plots. 


You can enter some or all of the codes as an APL matrix: for more information, see “Matrix Definition 
of Labels or Codes”, 


You can enter several codes on the same line by separating them with comm: 
enter codes for the five countries thus 


for example, you could 


CODE’ (1) : USA,UK,GER,CAN,AUS 


WIZARD then prompts you for the number of codes for the next dimension, and so on 


CODE 2 


(1) WO. OF CODES FOR-PACKACE:3 
CODE3 (1) : D,B,C 


CODE? refers to attribute codes in the second dimension {that is, PRODUCT). CODE2 (3) means that 
you should enter codes for the second dimension, starting at the third code. 


Once you've entered all the codes, WIZARD asks: 


OK? ANSWER Y TO CON 


BPO CHANGE CODES (Y/N):¥ 


Answer YES if previous replies to prompts are correc 
NO to begin changing the codes you've just defined. 
CC suboption of ALTE: 


WIZARD will proceed to the next section. Enter 
The prompts and effects are the same as the 
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Specifying a File’s Scale 


WIZARD next prompts you to specify the file’s scale, that is, the maximum number of decimal places 
in the data: 


SPECIFY INTERNAL DECIMAL SCALE FACTOR 
MAX. NO. OF DECIMAL PLACES FOR ANY NUMBER: 0 
The maximum number of decimal places determines how many decimal places you can enter when 


you edit the file. For example, if you type O—meaning no decimal places—you will be allowed to enter 
only whole numbers (integers). For a discussion of scale, see “File Design”. 


MacicSrork scales up data into an integer format using the scale you specify. Numbers greater than 
2,147,483,047 or less than -2,147,483,648 ("1+2*31 and ~2%31, respectively) occupy twice the file 
space of smaller numbers. So if you specify a larger scale than you really need, data components may 
double in size. 


Specifying a File’s Organization 


WIZARD next prompts you to specily how you want the file organized internally. The effects of these 
specifications are not usually obvious to you; however, they are very important to the cost of using 
the file. 


SPECIFY FILE ORGANISATION 


WIZARD displays the number of codes (that is, attributes) defined for each of the file’s dimensions, and 
then asks you if more codes (in effect, attributes) are to be defined sometime in the future: 


NUMBER OF CODES FOR EACH DIMENSION IS- 3 4 5 
WILL MORE CODES BE ADDED LATER(Y/N)? : YES 


Answer WO if you do not expect more attributes to be added; and YES if you do. If you answer 
YES, WIZARD prompts you for the expected number of codes in each dimension: 


ENTER MAX. NO. OF CODES/DIMENSION: 20 7 5 


Enter the maximum number of codes (20 7 5, corresponding to 3 4 5, which you specified when 
creation began) that will be required for expansion in each dimension before the file is reblocked. There 
must be as many numbers as dimensions. and the numbers must be greater than or equal to those 
previously specified. Most files tend to expand—even those you don’t expect to—so it’s a good idea 
to allow some extra attributes. (You can add attributes indefinitely over a partitioning dimension; this 
is discussed in “File Design™.) 


If you indicate that a nonpartitioning dimension may expand, MacicSrorr allocates extra space in 
the data components for these dimensions. You can use this additional space to expand whichever 
dimension you choose, subject to there being enough space in the file. Instead of 5 5 6 (150 values 
in each period), you could have 3 4 12 (144 values) or 3 10 5 (150 values). A MagicSrorr data 
component has a fixed size, so the more room you reserve for attributes in cach dimension, the fewer 
periods in each component. If you double the number of attributes in any dimension you will halve 
the number of periods. This means that MacicSrore will have to search through twice as many data 
components when it reads data from the file; that is, increasing the space available for future expansion 
makes MacicStore less efficient. You should therefore enter realistic estimates. 
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You are now prompted for the file partitioning: 


PARTITION DIMENSION(S) (DEFAULT=DATE): DATE 
NO. OF DATE /BLOCKS IS 46 ( 46.67) OK (Y/N)? : YES 
NEW DATABASE 'SALES' CREATED 


Example 


This is a complete example of how to create a MacicSrore file. In this example, the file is partitioned 
on the COUNTRY dimension; the example in “A Glimpse of MacicSrore” uses default partitioning. 


* CREATE FILE 


FILE:SALES 
FILE ‘SALES' CREATED 


SPECIFY DATABASE FREQUENCY AND TITLE 


PREQUENCY (D/W/M/Q/S/¥/G/0) : QUARTERLY 
REPORT TITLE:THE FROTHY BEER COMPANY PLC: QUARTERLY SALES 


SPECIFY DIMENSION NAMES AND CODES 


NO. OF DIMENSIONS EXCEPT TIME: 3 
DIMENSION (1) :COUNTRY 
DIMENSION (2) :PRODUCT 
DIMENSION (3) :PACKAGE 
BIMENSION-1 


NO. OF CODES FOR-COUNTRY:5 
CODE1 (1) : USA 

CODE1 (2) : UK 

CODE1 (3) : GER 

CODE1 (4) : CAN 

CODE1 (5) : AUS 
DIMENSION-2 

NO, OF CODES FOR-PRODUCT :4 
CODE2 (1) : PA 

CODE? (2) : LA 

CODE2 (3) : ST 

CODE2 (4) : RA 

DIMENSION-3 

NO. OF CODES FOR-PACKAGE:3 
CODE3 (1) : D 

CODE3 (2) : B 

CODES (3) : C 

OK? ANSWER Y TO CONTINUE, N TO CHANGE CODES (Y/N):YES 


SPECIFY INTERNAL DECIMAL SCALE FACTOR 
MAX WO. OP DECIMAL PLACES FOR ANY NUMBER: 0 


SPECIFY FILE ORGANISATION 
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NUMBER OF CODES FOR EACH DIMENSION IS- 5 & 3 

MORE CODES BE ADDED LATER (Y/N)? : YES 

ENTER MAX NO. OF CODES/DIMENSION: 20 7 5 

PARTITION DIMENSION(S) (DEFAULT=DATE): COUNTRY 
BLOCKING FACTOR(S) FOR-COUNTRY: 5 

NO. OF DATE /BLOCKS IS 40 ( 40.57) GK (Y/N)? : YES 
NEW DATABASE 'SALES' CREATED 


EDITING A FILE: THE UPDATE AND AMEND OPTIONS 


WIZARD has two options for editing (that is, entering) data: UPDATE and AMEND. Select UPDATE to store 
new information; and AMEND to change data on file. UPDATE assumes that you don’t intend to overwrite 
old data (and so tells you if you're about 10); but AMEND assumes you do intend to overwrite (or change) 
existing data (and so displays what's already there). 


Both UPDATE and AMEND store dati 
change information in a file. Mace 
to it with either option. 


in exactly the same way. You can use either option to add or 
TORE increases the size of the file (if necessary) if you add data 


If you select either option, MacicSrorr prompts you to select the file (if one is not currently selected), 
and periods to be updated or amended: 


OPTION: AMEND 

* AMEND 

FILE: SALES 
PERIOD: 1 80 

1 DATE SPECIFIED 


MacicSvore then asks you whether you want to enter data only for certain attributes, and if you 
want to change the order in which you'll be prompted for input: 


SET ATT} 


UTES OR USE DEFAULTS (S/D): SET 


Answer SET if you want restricted or reordered input; otherwise, answer DEFAULT. (Your reply can 
be as short or D.) Data for attributes not specified will remain unchanged on the file. If you enter 
SEP, MacicSvore prompts you to specify which of the non-DATE dimensions you want to set: 


SET hk 


H DIMENS 


: COUNTRY 


MacicSrox® then prompts you to specify the attributes you want to emer data for 


UK GER 

For example, you could enter 2 2 or 1-3,5,7-12; the latter is equivalent to 1 2 2.5 7 8 § 
41 12. ‘Typing ALL means that you wish to enter data for all attributes of this dimension, in 
default order. ‘The prompt is repeated for each of the dimensions you specified to the SET WHICH 
prompt 


MacicSrore then prompts vou to specify the order in which you want to be prompted for dimensions 


ORDER: DATE COUNTRY ,PRODUCT , PACKAGE 
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Specify dimensions by name or number. If you just hit RETURN, MacicSrore uses the default dimen- 
sion order: that is, DATE followed by the other dimensions in the order specified when the file was 
created. ‘The order of dimensions affects the way in which you are prompted for data entry. 


You don’t have to specify every dimension; the dimensions you omit are prefixed to those you specify. 
For example, if the current order is 4 1 2 3 (the default), and you specify ORDER 2 1, the resulting 
dimension order is 4 3 2 1; that is, the omitted dimensions—4. . . 3— followed by the specifed dimen- 
sions—-2 1. For more information about dimension-ordering, see “The ORDER Command” 


MacicStore now prompts you for data: 


PACKAGE- DRAUGHT , BOTTLES ,CANS 


DATE - 15T QTR 1980 
COUNTRY- UNITED KINGDOM 
PRODUCT- 

1. PALE ALE: 23 45 12 

2. LAGER 100 24 12 
3. STOUT 7 46 


The first line—PACKAGE -DRAUGHT , BOTTLES ,CANS—names the three attributes whose values you are 
prompted for at each input line. The data you enter is for the last dimension you specified at the 
ORDER prompt; in this example, PACKAGE. 


MacicSvore checks the input for the correct number of values and number of decimal places. Decimal 
places must be less than or equal to the maximum specified when the file was created. The cardinal 
numbers in front of each prompt (1., 2., 3., ete.) identify each prompt. You can jump backward 
or forward to another prompt by entering +1ine, where line is the line you want to jump to. In 
the example above, you skip to line 6: data for the skipped prompts 3, 4, and 5 is unchanged, or is 
zero if there were no previous values. If you enter STOP at a data prompt, you return to the previous 
prompt. If you enter EXIT at a data prompt, you're taken right out of UPDATE or AMEND, and the 
file is not updated. 


Both UPDATE and AMEND put you in an emulation of evaluated-input mode. Thus you can enter as 
input any SHARP APL expression with a numeric result; for example: 2+10 12 14, or 3050. Also, 
you can use your own input utility language; for a discussion of this, see “Data Entry Aids” 


If you select the AMEND option, then MacicSrore displays old values before it prompts you for a new 
input line, unless the oid data is not significant (that is, all zeros and you've set or allowed 
NOZERO). 

If you select the UPDATE option, MacicSrore assumes that you are entering new data or overwriting 
zeros. Therefore, MacicStore does not display old values before it prompts you for input. If 
MaaicSrore finds that you are about to overwrite significant data, it asks: 


DATA ALREADY EXISTS ON FILE ... OVERWRITE (Y/N)?: YES 


Enter YES if you wish to overwrite data. Enter NO if you want to exit, leaving the data as it stands. 


When you've properly entered all required data, MacicStore displays 


FILE UPDATED 
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If you type EXIT at any of the prompts, the file is not modified. (The values you entered remain in 
the global variable DATA until you next edit or get data.) 


Examples 


In the first example, a complete set of data is entered for the third quarter of 1980. Some data 
previously stored in the file is overwritten, but these old values are not displayed: 


* UPDATE 

FILE :SALES 

PERIOD TYPE -QUARTERLY 

PERIOD:3 80 

SET ATTRIBUTES OR USE DEFAULTS (S/D): DEFAULT 

ORDER: RETURN 

DATA ALREADY EXISTS ON FILE ... OVERWRITE (Y/N) ?: YES 


PACKAGE- DRAUGHT , BOTTLES ,CANS 


DATE ~- 3RD QTR 1980 
COUNTRY- UNITED STATES 
PRODUCT- 

1. PALE ALE: 750 244 244 
2. LAGER : 0 

3. STOUT : 708 245 232 
4. REAL ALE: 0 

COUNTRY- UNITED KINGDOM 


PRODUCT- 

5. PALE ALE: 49 21 70 
6. LAGER : 0 20 181 
7. STOUT : 83 28 173 


8. REAL ALE: 8 15 50 
COUNTRY- GERMANY 


PRODUCT- 

9. PALE ALE: 139 74 23 
10. LAGER £30 

11, STOUT : 224 38 157 


12. REAL ALE: 0 37 0 
COUNTRY- CANADA 


PRODUCT- 

13. PALE ALE: 10 75 21 
14. LAGER : 0 

15. STOUT : 224 38 157 


16. REAL ALE: 0 370 
COUNTRY- AUSTRALIA 


PRODUCT- 

17. PALE ALE: 731 
18. LAGER 30 

19. STOUT : 53 10 40 


20. REAL ALE: 060 


FILE UPDATED 


Chapter 4: CONVERSATIONAL MAGICSTORE 39 


In the next example, some data in a file is amended. Only CANS and DRAUGHT from the third dimension 
(PACKAGE) are selected: 


* AMEND 

FILE :SALES 

PERIOD TYPE -QUARTERLY 

PERIOD:3 80 

SET ATTRIBUTES OR USE DEFAULTS (S/D): SET 
SET WHICH DIMENSIONS: PACKAGE 

*PACKAGE' SET: HELP 

SELECT FROM ...(1)D,(2)B,(3)C 

'PACKAGE' SET: D,C 

ORDER : RETURN 


PACKAGE- DRAUGHT ,CANS 


DATE - 3RD QTR 1980 
COUNTRY- UNITED STATES 
PRODUCT- 

WAS - 750 244 
1. PALE ALE: 738 247 
2. LAGER 29 

COUNTRY- GERMANY 

PRODUCT- 

WAS - 139 23 
9. PALE ALE: 142 27 
10. LAGER : 717 

COUNTRY- AUSTRALIA 

PRODUCT- 

WAS - 71 
17. PALE ALE: 8 2 
18. LAGER : +9999 


FILE UPDATED 

> ‘right arrow’ is used to branch from line 2 to line 9, and from line 10 10 line 17. Only those values 
that you enter are amended on the file. All the values that you skip using + retain their previous values. 
LISTING DATA FROM A FILE: THE LIST OPTION 

Select the LIS? option to display data from a MacicStore. file. 

x LIST 


When you select LIST, WIZARD prompts you to select the file (if one is not currently selected) and 
periods to be processed: 
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FILE : SALES 
PERIOD TYPE - QUARTERLY 
PERIOD : 1 80 TO 4 80 


WIZARD then prompts you to set up the listing by selecting various LIST suboptions: 
SEP /PAGE/ROWS/COLS/TOT/AVE/NOD: SET ,ROWS ,COLS 
Enter a list of one or more of these suboptions: 
RETURN 
indicates that you want none of the suboptions. The listing is produced according to the state current 


when you selected LIST. WIZARD directly lists the data. 


ALL 
specifies that you want all of the suboptions. 


SET 


specifies that you want to select or reorder the attributes to be listed 


PAGES 
specifies that you want to select the dimensions to head each page of the listing. 


ROWS 
specifies that you want to select the dimensions that are to form the listing’s rows. 


COLS 
specifies that you want to select the dimensions that are to form the listing’s columns 


TOTAL 
specifies that you want to select dimensions whose totals are to be calculated and displayed. 


AVERAGE 
specifies that you want to select dimensions whose averages are to be calculated and displayed 


NODETAIL 
specifies that you want to select dimensions whose details are to be suppressed. 


Each of these suboptions (except ALL) is described below. 

WIZARD processes in turn cach suboption you select. After it has processed all the suboptions, 
WIZARD prints a few spaces to tell you to align the paper in your terminal; and waits for you to press 
RETURN. The listing is then displayed at your terminal. 

The SET Suboption 


If you select SET, WIZARD prompts you to specify the dimensions you want to set; that is, the 
dimensions whose attributes you want to select or reorder: 


SET WHICH DIMENSIONS: PRODUCT , PACKAGE 


‘PRODUCT’ SET: LA,PA 
"PACKAGE' SET; 1 3 


Chapter 4: CONVERSATIONAL MAGICSTORE 41 


You can enter ALE to indicate that all attributes of this dimension are to be listed, and in their default 
order. This prompt is repeated for every dimension you specified to the SET WHICH DIMENSIONS 
prompt. 


The PAGES Suboption 


If you select PAGES, WIZARD prompts you to specify the dimensions you want to head each page ol 
the listing: 


PAGES : PACKAGE 
You can enter RETURN to indicate that no dimension is to head the listing's pages 
The order in which you specify the dimensions affects the layout of the listing: the first is the outermost 


dimension. When you select dimensions for the listing’s pages, you must leave at least one dimension 
each for the listing’s rows and columns. 


The ROWS Suboption 

If you select ROWS, WIZARD prompts you to specify the dimensions that are to form the listing's rows: 
ROWS : DATE ,PRODUCT 

You must leave at least one dimension unselected here, for the listing's columns. The default state of 
ROWS is to have DATE and then all non-DATE dimensions but the last. For example, in the Frothy 
Beer Company's SALES file, the default ROWS state is DATE ,COUNTRY , PRODUCT. 

The COLS Suboption 

If you select COLS, WIZARD prompts you to specify the dimensions that are to form the listing's columns: 
COLS : COUNTRY 

You must leave at least one dimension unselected here. for the listing’s rows. Vhe default state of 
COLS is to have the last non-DATE dimension. For example, in the Frothy Beer Company's SALES 
file, the default COLS state is PACKAGE. 

The TOTAL Suboption 


If you select TOTAL, WIZARD prompts you to specify the dimensions whose totals you want calculated 
and listed: 


TOTAL : COUNTRY , PRODUCT 


You can enter RETURN to indicate that no dimension is to be totalled. 
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The AVERAGE Suboption 


If you select AVERAGE, WIZARD prompts you to specify the dimensions whose averages you want 
calculated and listed 


AVERAGE : DATE 


You can enter RETURN to indicate that no dimension is to be averaged. 


The NODETAIL Suboption 


If you select NODETAIL, WIZARD prompts you to specify the dimensions whose details you want 
suppressed: 


NODETAIL: COUNTRY 


NODETAIL means that the data for the specified dimension’s attributes is not to be listed; that only 
the dimension’s total or average is to be listed. If you do not specify the TOTAL or AVERAGE suboption 
for a NODETAIL dimension, that dimension is totalled by default (that is, TOTAL is forced). 


Examples 
All data for the first quarter of 1980 is listed in the défault order; no calculations are done: 


WIZARD 
OPTION: LIST 
* LIST 
FILE : SALES 
PERIOD TYPE - QUARTERLY 
PERIOD : 1 80 
SET/PAGE/ROWS/COLS/TOT/ AVE/NOD: RETURN 
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E FROTHY BEER COM! 


PANY PLC: SALES 


DRAUGHT | BOTTLES | 


4ST QTI 
UNITED STATES 
PALE ALE 632 
LAGER 
STOUT 
REAL ALE 
INITED KINGDOM 
PALE ALE 51 
79 
& 
145 
STOUT 220 
REAL ALE 
CANADA 
PALE ALE 11 
LAGER 
STOUT 11 
REAL ALE 
AUSTRALIA 
PALE ALE 7 
LAGER 
STOUT 43 
REAL ALE 


245 
227 
67 
183 
180 
51 
25 


166 


21 


Data for the first half of 1980 is listed in a reordered format (the word “pace” indicates where 


MacicSrore will start a new page) 


SET/PAGE/ROWS/COLS/TOT/AVE/NOD: PAGES ,ROWS ,COLS ,TOTAL 


* LIST 
PILE : SALES 
PERIOD TYPE - QUARTERLY 
PERIOD : 1 80 2 80 
PAGES : DATE 
` : PACKAGE , COUNTRY 
: PRODUCT 
: COUNTRY 
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THE FROTHY BEER COMPANY PLC: QUARTERLY SALES 


DATE: 1ST QTR 1980 


| PALE ALE| LAGER | STOUT| REAL ALE{ 

DRAUGHT 

UNITED STATES 632 679 

UNITED KINGDOM 53 79 8 

GERMANY 145 220 

CANADA 11 it 1 

AUSTRALIA 7 43 

COUNTRY TOTAL 846 1032 9 
BOTTLES 

UNITED STATES 239 223 

UNITED KINGDOM 19 18 26 15 

GERMANY 65 42 34 

CANADA 77 82 8 

AUSTRALIA 3 9 6 

COUNTRY TOTAL 403 18 382 63 
CANS 

UNITED STATES 245 227 

UNITED KINGDOM 67 183 180 51 

GERMANY 25 166 

CANADA 21 22 2 

AUSTRALIA 1 43 

COUNTRY TOTAL 359 183 638 53 


PAGE 
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COMPANY PLC: QUARTERLY SALES 


DATE: 


LISTING THE DIRECTORY OF A FILE: THE DIRECTORY OPTION 


Select the CTORY option to display the parameters of a MacicSrore file. The parameters dis- 
played are: title: number of periods stored, and their range; scale (maximum number of decimal places); 
dimensions: attributes; and automatic calculations. 


When vou select Z IZARD prompts you to identify the MacicSror: file whose parameters 
are to be displaved - if a file is not already selected: 


then displays the selected file's parameters. Here’s a complete example: 
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PILE: 1234587 SALES 

TITLE: THE FROTHY BEER COMPANY PLC: SALES 

QUARTERLY : 12 PERIODS FROM- 1ST QTR 1980 TO- 4TH QTR 1982 
MAX NO. OF DECIMALS: 0 


DIMENSION 1: COUNTRY 


CODES LABELS 


(1) USA UNITED STATES 
(2) UK UNITED KINGDOM 
(3) GER GERMANY 

(4) CAN CANADA 

(5) AUS AUSTRALIA 


DIMENSION 2: PRODUCT 


CODES LABELS 


(1) PA PALE ALE 
(2) LA LAGER 
(3) ST STOUT 
(4) RA REAL ALE 


DIMENSION 3: PACKAGE 


CODES LABELS 


(1) D DRAUGHT 
(2) B BOTTLES 
(3) C CANS 


CHANGING A FILE’S PARAMETERS: THE ALTER OPTION 

Select the ALTER option to change the values of a file’s parameters. Specifically, select ALTER: 10 change 
a file's name. title, scale, frequency, format, or its dimension names, or attribute labels or codes; to 
add, delete, or restore attributes; or to reblock the file. 


* ALTER 


After you've selected ALTER, WIZARD prompts you to select the file whose parameters are to be 
changed—if a file is not already selected: 


FILE: SALES 
WIZARD then prompts you to select a suboption: 


ALTER OPTION: CT 
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Select a suboption from this list: 


AD Add attributes 
AP Define period labels 


CA Change automatic calculations for Macic access 
ce Change attribute codes 
cD Change dimension names 


CF Change format 

cL Change attribute labels 

cP Change frequency 

CN Change a MacicSrorr. file name 


cS Change scale 
cr Change tide 
DL Delete or restore attributes 


RB Reblock the file 


Fach of these suboptions is described in turn. 


Adding Attributes: The AD Suboption 

Select the AD suboption to add attributes to a dimension: 

* ADD CODES 

After you select AD, WIZARD prompts you to specify the dimension to which attributes are to be added: 
DIMENSION(S): COUNTRY 

DIMENSION-COUNTRY 

MAX. NO OF CODES FOR COUNTRY IS- 7 

If the dimension you select is not partitioned, you are told the maximum number of codes you can 
define. You can then display the codes already defined in that dimension by answering Y at the next 


prompt: 


PRINT EXISTING CODES (YES/NO)? YES 
CODES ARE: (1) USA, (2) UK, (3) GER, (4) CAN, (5) AUS 


WIZARD then asks you how many codes you want to add: 
ADD HOW MANY CODES: 2 


WIZARD then prompts you for the new codes, each in turn; the prompt includes the next new attribute’s 
number (in this example, 6): 


CODE (6) :ITA,FRA 


Enter each new code. You can enter one code; or several (as here), separated by commas. The new 
codes are then stored on the file, and this message is printed: 


NEW CODES STORED 


48 Chapter 4: CONVERSATIONAL MAGICSTORE 


Defining Period Labels: The AP Suboption 

Select the AP suboption to define nonnumeric period labels for MacicSrors. files whose frequency is 
OTHER. After you select AP, WIZARD prompts you to specify the periods you want to label: 
PERIOD(S):3 4 

Enter the indices of existing periods. WIZARD then prompts you for the labels: 

PERIOD LABEL (3) : BUDGET 

PERIOD LABEL (4) : ACTUAL 


Changing Automatic Calculations: The C4 Suboption 


Select the CA suboption to set or reset automatic calculations for Mactc access. For more information, 


see “Automatic Calculations” 


x SET AUTOCALC FOR MAGIC ACCESS 


After you select CA, WIZARD prompts you to specify the dimension whose automatic calculations you 
want to set 


DIMENSION FOR AUTOCALC: COUNTRY 


You should specily any dimension for which you wish to specify a timepacking calculation for Maci 
access. (The calculations are performed when data is summarized over time. For example. if 
SALES data were displayed in Macie with a YEARLY frequency set, you would want the displayed 
data to be the total of the four quarters in each year. On the other hand, yearly retrieval of monthly 
PRICE data should give each year’s average or last value.) 


WIZARD prompts you to set attributes to which automatic calculations are to apply; you'd usually enter 
ALL 


"COUNTRY' SET:ALL 


WIZARD next prompts you to specify the automatic calculations you want to associate with each set 
attribute: 


AUTO CALCULATIONS : AVERAGES 
You can specify any of: 


TOTALS 
AVERAGES 


M 
MAXIMUM 
DAILYAVERAGE 


The default is TOTALS. 


If you enter only one calculation (as above, for example), this entry is applied to every set attribute. 
If you enter fewer calculations than there are attributes, the values you do enter are wrapped around 
until every attribute has a value. 
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When WIZARD has successfully added the automatic calculations to the file’s directory, it displays: 


AUTOCALC SET 


Changing Attribute Codes: The CC Suboption 
Select the CC suboption to change any of a file’s attribute codes: 
* CHANGE CODE 


After you select CC, WIZARD prompts you to specify the dimensions whose attribute codes you want 
to change: 


DIMENSION(S): PRODUCT 


WIZARD deals with each dimension in turn. It displays the name of the first dimension you specified, 
and asks if you want this dimension’s attribute codes displayed: 


DIMENSION: PRODUCT 
PRINT CODES (Y/N)? YES 


Answer YES or NO. If you answer YES, WIZARD displays the current attribute codes: 

CODES ARE: (1)PA, (2)LA, (3)ST, (4)RA 

WIZARD then prompts you to specify which attributes you want to recode: 

CHANGE CODE(S): 2-4 

In this example, the reply 2-4 means the second through fourth attributes. WIZARD then prompts you 
to enter each specified attribute’s new code. The prompt includes the attribute’s number; this number 


does not change: 


CODE (2) LAG,IPA 
CODE (4) XTRA 


Enter the new codes. You can enter several codes in one line, separating them with commas. 
WIZARD repeats this prompt until you have recoded every attribute you specified. After you’ve recoded 
every attribute of every dimension you specified, WIZARD displays: 


CODE(S) CHANGED 


Changing Dimension Names: The CD Suboption 
Select the CD suboption to rename any of a file’s dimensions, even DATE. 
* CHANGE DIMENSION NAME(S) 


After you select CD, WIZARD displays the current dimension names and prompts you to specify the 
dimensions you want to rename: 


DIMENSION NAMES ARE- (1)COUNTRY, (2)PRODUCT, (3)PACKAGE, (4)DATE 
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CHANGE DIMENSION NAME(S): 2 


WIZARD prompts you for the first new dimension name. ‘The prompt includes the dimension’s number; 
this number does not change: 


NEW DIMENSION NAME (2) : BRAND 


Enter the new dimension name. WIZARD repeats this prompt until you’ve renamed every dimension 
you specified. Then WIZARD displays 


DIMENSION NAME(S) 2 CHANGED 


Reformatting a File: The CF Suboption 
Select the CF suboption to reformat a file; that is, to change how MacicSvore lists data from the file. 
» CHANGE FORMAT SPEC 


After you select CF, WIZARD asks you whether you want to change the file's scale, that is, its maximum 
number of decimal places: 


DO YOU WANT TO ALTER THE MAX. NUMBER GF DECIMALS(Y/N)? YES 

If you answer YES, WIZARD displays the file's current scale, and prompts you to specify the new seale 
* CHANGE SCALE 

MAX NO. OF DECIMAL PLACES FOR DATABASE SALES IS: 2 

NEW MAX. NO. OF DECIMALS:3 

Enter any integer from 0 to 9. WIZARD then displays: 

NEW NO. OF DECIMAL PLACES OF 3 STORED 

If scale is to remain the same, reply NO. WIZARD then prompts you to specify the formatting dimension 


DIMENSION FOR FORMAT: PACKAGE 


The formatting dimension is the dimension for which you wish to display attributes at diflerent column 
widths or decimal places. If all data is of the same format, choose any dimension. 


WIZARD then prompts you to specify the minimum format widths for the formatting dimension. 
FORMAT WIDTHS E.G. 76: 8 9 10 


Enter one or more widths. The widths you enter apply to each attribute in turn: if you enter only 
one width, it applies to every attribute; if you enter fewer widths than there are attributes, they apply 
to the attributes over and over again in turn; if you enter more widths than there are auributes, the 
extra widths are not used 


If the scale for this file is not O, then WIZARD prompts you to specify the number of decimal places 
to be allowed in each attribute 


DECIMAL PLACES E.G. 12: 021 
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Enter one or more numbers of decimal places; each number must be an integer from 0 to 10, and 
at least 2 less than the corresponding format width. (For example, if the format widths are 5 6 8, 
the decimal places should not be more than 3 4 6.) The numbers you enter apply to each attribute 
in turn: if you enter only one number, it applies to every attribute; if you enter fewer numbers than 
there are attributes, they apply to the attributes over and over again in turn; if you enter more numbers 
than there are attributes, the extra numbers are not used. 

WIZARD then displays: 


FORMAT SPEC UPDATED 


Changing Attribute Labels: The CZ Suboption 
Select the CL suboption to change any of a file’s attribute labels: 
* CHANGE LABELS 


After you select CL, WIZARD prompts you to specify the dimensions whose attribute labels you want 
to change: 


DIMENSION(S): PRODUCT 


WIZARD deals with each dimension in turn. It displays the name of the first dimension you specified, 
and asks if you want this dimension’s attribute labels displayed: 


DIMENSION -PRODUCT 
PRINT LABELS (Y/N) :YES 


Answer YES or NO. If you answer YES, WIZARD displays the current attribute labels: 


(1) PA -PALE ALE 
(2) LA -LAGER 
(3) ST -STOUT 
(4) RA -REAL ALE 


WIZARD then prompts you to specify which attributes you want to relabel: 
CHANGE LABELS: 2-4 


(2-4 means the second through fourth attributes.) WIZARD then prompts you to enter each specified 
attribute’s new label: 


LA :LITE LAGER 
ST :EXTRA STOUT 
RA :WARM BEER 


Enter the new labels. WIZARD prompts for each label, with its corresponding attribute code, until you 
have relabelled every attribute you specified. After you've relabelled every attribute of every dimension 
you specified, WIZARD displ 


LABEL(S) CHANGED 
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Changing a File’s Name: The CX Suboption 


Select the CH suboption to rename the currently selected MacicSvore. file: 


ME 
€ 1234567 NEWS 
E: SALESM 
1234567 BEWSAL, 


- CHANGED TO - 1234567 SALESM 

Renaming a MacicSvorr file may cause problems for users of the file. Any Macic access function 
for the file must be now recreated with LINX, and references 10 the fle name in any SHARP APL 
program that uses the FILE command must also be changed. 


Changing a File’s Frequency: The CP Suboption 


Selec the CE suboption to change a file’s frequency (“periodicity”). You can change the frequency only 
if no data ix stared on the file. 


* CHANGE PERIOD 


After you select CP, WIZARD 


frequency: 


D displays the current frequency, and prompts you to specify the new 


QUARTERLY 
TYPE (D/W. 


M/Q/S/Y/G/0): MONTHLY 


Enter the file's new frequency; it must be one of: 


(For a discussion of frequency, see “Creating a File”.) Then WIZARD displays: 


NEW PERIOD TYPE ST 


Changing a File’s Scale: The CS Suboption 


Select the CE suboption to change a file’s seale, that is, the maximum number of decimal places allowed 
in the file: 


* CHANGE LE 


Alter you select CS D displays the file's current scale, and prompts you to specify the new scale 
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OF DECIMAL PLACES FOR DATABASE SALES IS: 0 
RG. OF DECIMALS:3 


Enter any integer from 0 to 9. WIZARD then displays: 


NEW NC. GF DEC. PLACES OF 3 STORED 


Changing a File’s Title: The C? Suboption 


Select the CT suboption to reenter the MaGicSrorr. file's title; that is, the text that MacicSrorr. uses 
to head listings of the file. 


+ CHANGE TI 


E 


After you select CT. WIZARD displays the current title and prompts you to reenter the title: 


q z DATABASE SALES IS-SALES OF BEER FOR FROTHY BEER COMPANY 
NEW TITLE :FROTHY BEER QUARTERLY SALES 


Enter the new tide. A file title may be any number of characters, and can include any typable SHARP 
APL. character. When you enter a new ttle, WIZARD responds: 


NEW PIPE 


Deleting or Restoring Attributes: The DL Suboption 


Select the DL suboption to delete attributes from or restore attributes to a file’s dimensions. A “deleted” 
attribute is actually deleted only when the file is reblocked; you can restore a “deleted” attribute until 
then. However. MacicSrorr zeroizes data on file for deleted attributes as soon as you mark them 
deleted. 


After you select £ 
from. or restore at 


prompts you to specify which dimensions you want to delete attributes 
ibutes to: 


(£): PACKAGE 
For each specified dimension in turn, WIZARD asks you if you want to display all the currently defined 
codes (including anributes “deleted” but not actually removed), and prompts you to specify which 


auributes you want to delete or restore: 


PACKAGE 


(Y/N) YES 
(3)¢ 


SELETE/ RESTORE 


Enter one or more names or numbers. For each attribute thus specified, WIZARD prompts you to specify 
whether the auribute is to be deleted or restored: 
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When every specified auribute of every specified dimension has been deleted or restored, WIZARD 
displays cither CODE(S) DELETED or CODE(S) RESTORED. 


Reblocking a File: The RE Suboption 


Select the RB suboption to respecify the file structure and to copy the data into a new file with this 
structure. Reblocking does not erase the old file; that is left up to you. To replace the old file with 
the reblocked version, you must rename or erase the old file and rename the reblocked version with 
the name of the old file 


- TO -SALESRB 


WSION IS- 743 
TER (Y/N)? : NO 
=DATE): PRODUCT 
T: 1 


338.10) OK (Y/N)? : YES 


e 
Cd 
FILE -SALESAB- IS NOW REBLOCKED VERSION OF - 1234567 SALES 
ACCESS MATRIX SET FOR -SALESRB 

wW D prompts you to identify the new fle, and then to specify the new file's organization. (The 
format prompts are the same as those issued by the CREATE option.) WIZARD copies data from the 
old file to the new, printing C ‘quad’ for each component read from the old file: 


Reblocking a file can be expensive and time-consuming, especially if data from one component of the 
old file is written to several components of the new file. 


‘The user now erases the old file and renames the new file: 


OPTION: ERASE 


-SALES... ARE YOU SURE (Y/N) ?: YES 


FILE: SALESRB 


- CHANCED TO - 1234567 SALES 
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GIVING ACCESS TO A FILE: THE ACCESS OPTION 


Select the ACC: 


option to give other users access to your MacicStore file: 
x ACCESS TO FILES 

WIZARD prompts you to select a file. if one is not currently selected 
FILE:SALES 

WIZARD then asks you to select a suboption: 

ACCESS OPTION (PR/PW/WI/US):PR 


Select a suboption from this fist: 


PR Permit read access only 

PW Permit read and write access 
WI Withdraw access 

US List access 


USER NUMBERS :3540178 2810785 
* PERMIT READ ACCESS 
READ ACCESS 3ET 


If you select PR. EW, or WI, you are prompted for the user numbers to be added or deleted from the 
file's ac Suboption US just displays a report of the user numbers by the type of file access 
they have. If you give access to user number 0, this will allow any user to use your tile. 


ERASING A FILE: THE ERASE OPTION 
Select the ERASE option to erase a MacicStore file. 
* ERASE FILE 
When you select ERASE. WIZARD prompts you to identify the files you want to delete 
FILE: SALES 
IZARD then asks you to confirm that cach identified file is to be crased: 
DELETING FILE-SALES... ARE YOU SURE (Y/N)?: YES 
Answer YES or WO. If you answer YES, WIZARD displays: 


PILE DELETED 
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DELETING PERIODS: THE DELETE OPTION 


Select the 


ETE option to delete periods—and the data associated with these periods—from a file 


J prompts you to identify the file you want to delete periods from 
(if a file is not currently selected). and then the periods you want deleted 
1 SALES 

:1 79 TO 4 79 


ARD then displays: 


RESELECTING THE FILE: THE } 


E OPTION 


E option to select another MacicSrore file for processing. 


Select the 


WIZARD prompts you to identify the file you want selected: 
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Chapter 5 


NONCONVERSATIONAL MAGICSTORE 


You can use MacicSvorE nonconversationally by executing MacicStore commands. 


THE STATE COMMAND 
Use the STATE command to display the current MacicStore state. Specifically, the STATE command 
display: 
o the file selected; 
© the frequency of the de 
e which of ATE and D has been set; 
e the order of the dimensions; which of the non-DATE dimensions is partitioned on (indicated by a 
star); and the attributes that have been set; 
© which of ZERO and NOZERO is set: 
the dimensions specified ar implied to PAGE, ROWS, COLS, TOTAL, AVERAGE, and NODETAIL; 
e the settings of WIDTH and DEPTH, 
which of LABELS 


and the number and range of stored periods; 


For example: 


FILE 
QUARTERLY : - 15T QTR 1980 TO- 4TH QTR 1982 
EDIT 

UPDATE 


EDIT/TIST 

a DATE 157 QTR 1980, 2ND QTR 1980, 3RD QTR 1980 

ATES, "ED KINGDOM ,GERMANY ,CANADA, AUSTRALIA 
E ALE, LAGER, STOUT REAL ALE 

HT , BOTTLES ,CANS 


THE FILE AND PERIOD COMMANDS 


You must select a file and periods before you can process data with MactcStore. Therefore, you must 
issue the F. and PERIOD commands—in that order—before you issue the EDIT, GETDATA, LIST, 
or PUTDATA command. For exampie: 
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FILE ‘*SALES' 
PERIOD 1 80 2 80 
2 DATES SPECIFIED 


PILE and PERIOD do not have default states. All other state setting functions (for example, TOTAL, 
ROWS, and SET) have default settings to which they are reset by the FILE command. 


The “ILE Command 

Use the FIZE command to select the MacicSrorr file you want to use. For example: 
FILE 'SALES* 
FILE *1234567 SALES' 


must select an 
1234567) if it is the sa 


ing MacicSrore file. You can omit the library number (for example, 
me as your current signon number. 


The PERIOD Command 


Use the FERICD command to select the periods to be processed by EDIT, GETDATA, LIST, and 
i I you update or amend data for periods that already exist on the files, then data for these 
periods is overwritten with the new information. Data for periods not specified is not altered. 


When extracting data from a file. if you specify periods for which no data is stored on the file, 
MacicSrore sets these values to zero. For example, if you read data from a file before you have stored 
any data, the data values read will all be zero. 


For more information, see “Specifying Periods”. 


THE ODER AND SET COMMANDS 


Use the CEDER and SET commands to transpose the sequence of the data dimensions, and to select 
and reorder data attributes within cach dimension. ORDER and SET affect the GETDATA, PUTDATA, 
T, and ESITDATA commands. You can reser ORDER and SET to their default values by reissuing 


the FILE command. 


The SET Command 


When you select a file, the auributes of the file are processed in the order that they were defined when 
the file was created. If you want to alter the sequence of attributes, you can use the SET command. 
In the Frothy Beer example, the default sequence of countries is: USA,UK,GER,CAN,AUS. Use SET 
to reorder or ignore countries: 


SET 'UK,USA,AUST* 
or 

'COUNTRY' SET 2 1 5 
or 


1 SET 215 
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(Either or both arguments may be numeric. Numeric arguments take less time for the computer to 
process.) Any of these three commands specifies the COUNTRY sequence to be UK,USA,AUS—that is. 
the second, first, and fifth attributes—and to exclude the third and fourth (GER,CAM®) 


You can set other dimensions, for example: 


"PACKAGE' SEP 'B,D,C* 
or 
"PRODUCT! SET ‘LA’ 


Use SET 10 specify which attributes are to be included in a listing or are to be prompted for when 
you enter data also determines which attributes are read from and written to a file. SET van be 
used with EDIT or GETDATA Ò EDITDATA © PUTDATA to update a file selectively; attributes ex- 
cluded in a SEP suuement remain unaltered. 


If you use codes rather than attribute numbers, then you don't have to specify the dimension to which 
the attributes belong, so long as the codes are unique in the file. If you use SET with no left argument. 


you can specily codes across several dimensions; such as PRODUCT and COUNTRY in this example: 


SET 'LA,GER,AUS' 
Here are some more examples of SET: 


"PRODUCT! SET 'ST,LA‘ 
3 SET 3 2 1 

1 SET 'UK,GER' 

2 SET 'PA' 

'PACK' SET 3 1 

1 SET ALL 


The sequence of attribute labels in the argument to SEP affects how the file is listed. If you enter 
3 SET 4 1, then attribute 4 of dimension 3 will be printed before attribute 1 of dimension 3. 


If you haven't issued the SET command in the current MacicSrore session, then all attributes of all 
dimensions are processed by MacicSrore commands in default order. You can return to this state 
by reissuing the FIZE command or by specifying the keyword ALL to SET. For example: 


‘PRODUCT’ SET ALL 
This is the same as either of the following: 


‘PRODUCT' SET 1234 
or 
‘PRODUCT' SET 'PA,LA,ST,RA' 


If you delete an attribute (using the DL suboption of WIZARD's ALTER option), then the attribute 
numbers you specify to SEY alsa change. For example, in the Frothy Beer example. 'PRODUCT' 
SEP 'LA,ST' is equivalent to 'PRODUCT' SEP 2 3. If the first code (PA) is deleted, then LA 
would become the first code and SP the second. Now 'PRODUCT' SET 1 2 would be equivalent to 
‘PRODUCT! SET'LA,ST'. Specifying an attribute code always selects the correct attribute, regardless 
of whether other attributes have been deleted. 
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The ORDER Command 
Use the ORDER command to change the order in which dimensions are presented in all operations. 


You needn't specify all the file’s dimensions to ORDER. The dimensions you do specify are moved to 
the end of the current order (see the second example below). 


The Frothy Beer Company's SALES file has four dimensions. Their default order is: 

DATE ,COUNTRY , PRODUCT , PACKAGE, that is, 4 1 2 3. But let’s say you want to change the presenta- 
tion of these dimensions to: PRODUCT , PACKAGE ,COUNTRY „DATE; you could enter either of these 
commands: 


ORDER *PRODUCT ,PACKAGE ,COUNTRY , DATE* 
or 

ORDER 2314 
THE LABELS AND CODES COMMANDS 


The LABELS and CODES commands affect EDIT, EDITDATA, LIST, and LISTDATA. 


Set S to indicate that file labels are to be used in prompts for data, and in row and column 
headings for listings. Set CODES to indicate that codes are to be used. The default state is LABELS, 


If you have a file with short codes and long labels, you might find it more convenient to use 
CODES for input prompts. Usually, LABELS would be used for data listings. For example: 


FILE 'SALES' 
PERIOD 1 82 
1 DATE SPECIFIED 
PAGES ‘DATE ,COUNTRY' 
ROWS ‘PRODUCT! 
COLS *PACKAGE! 
SET 'UK' 
GETDATA 
CODES 
EDITDATA 


PACKAGE-D,B,C 
DATE - 1ST QTR 1982 


COUNTRY- UK 

PRODUCT- 

1. PA: 51 24 84 

LA: 0 22 199 

ST: 100 33 183 

RA: 8 15 52 
PUTDATA 
LABELS 
LISTDATA 


FON 
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AND X0OZERO COMMANDS 
‘The ZERO and NOZERO commands affect EDIT, EDITDATA, LIST, and LISTDATA. 


The ZERO command specifies that the number Ô is to be printed in data listings, is to be included 
in the calculation of averages in listings. and is to be displayed when you use EDIT with AMEND set. 


The NOZERO command specifies thar the number O is not to be printed in data listings (instead, it 
is blank). but ts to be ignored in the calculation of averages, and is not to be signalled to you when 
you're about to overwrite it with AMEND set. 


THE EDIT, EDITDATA, UPDATE, AND AMEND COMMANDS 


Use the EDIT command to enter data. This data may be new or changed: you set UPDATE or 
AMEND to specify which. You set UPDATE to store new information; and AMEND to change data on file. 
Lhe difference between the two states is that UPDATE assumes that you don’t intend to overwrite old 
data (and so tells you if you’re about to); but AMEND assumes you do intend to overwrite (or change) 
existing data (and so displays what's already there) 


When you select a MacicSrore file, UPDATE is set. 


Po use the £ command, you must have properly selected the file and periods to be edited. You 
can further affect how EDIT works with the SET, ORDER, and ZEPO or NOZERO commands. For 
example 


FILE 'SALES' 

PERIOD 1 80 TO 3 80 

ECIPIED 

ORDER ‘COUNTRY ,PRODUCT , PACKAGE ,DATE' 
'COUNTRY' SET 'UK,USA* 

‘PRODUCT! SET 'LA' 

AMEND 

EDIT 


TE. 


EP command, you're prompted for data for all attributes of all dimensions. Unless 
command. you're prompted for data in the default order for the dimensions: that 
is, DATE followed by the other dimensions in the order in which they were created 


Unless you issue 


vou issue an Ož 
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If you set ZERO with AMEND, then EDIT will print the previous values on the file before it prompts 
you to enter the new values. For example, if you're about to change the values 23 45 12, then 
EDIT will produce this message 

WAS - 23 45 12 

If the values to be changed are all zero, the message is: 


WAS - 000 


if you set or allow NOZERO, “WAS -” messages for all-zero data are suppressed: and AMEND displays 
previous values only if at least one isn’t zero. 


Wf you issue the UPDATE command but MaicSrore finds that you are about to overwrite nonzero 
data, MacicStore asks: 


DATA ALREADY EXISTS ON FILE ... OVERWRITE (Y/N)?: YES 
Enter YES if you wish to overwrite the data; enter NO if you wish to leave the data as it stands. 


When you enter data. you can use any SHARP API, expression that has a numeric result. For more 


information, see “Data Entry Aids”. 


‘To skip prompts and therefore leave the data as it stands, enter a right arrow followed by the number 
of the prompt to which you wish to move; for example, +5. You may skip forwards or backwards 
to correct an error. You can also use + to leave EDIT: if you enter +n, where n is greater than the 
highest prompt number, MacicSrore removes you from EDIT, but all the values you've entered are 
applied to the file. 


‘Vo exit from EDIT, type EXIT: MactcSrork takes you out of EDIT completely and does not store 
data so far entered on the file. 


The sequence of activities for both the UPDATE and the AMEND modes of EDIT is as follows: 
+ Data is read from the file into the active workspace (with GETDATA) 

+ The data in the workspace is amended by your input at the terminal (with EDITDATA). 
¢ Once input is complete, the data in the workspace is stored on the file (with PUTDATA). 


Because of this, any values you don’t specifically amend or update retain their previous values. For 
example, if you set UPDATE and use EDIT to enter 20 lines of input; then leave UPDATE set and use 
EDIT to reenter oniy the Ist line, jump to the last line using +20 and reenter the last line: the 
remaining 18 lines remain as they were first entered and are not overwritten with zeros. 


For example: 


FILE 'SALES' 

PERIOD 1 80 TO 3 80 
3 DATES SPECIFIED 

SET 'UK,LA' 

AMEND 

EDIT 
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PACKAGE- DRAUGHT , BOTTLES ,CANS 


DATE - 157 QTR 1980 
COUNTRY- TED KINGDOM 
PRODUCT- 

WAS - 0 18 183 


1. LAGER: 0 20 184 
2ND QTR 1980 


CO. RY- UNITED KINGDOM 
PRODUCT- 

WAS - 0 20 195 

2. LAGER: 0 19 197 
DATE - QTR 1980 
COUNTRY- TED 
PRODUCT- 

W. O 20 181 


3. LAGER: 0 22 181 


FILE UPDATED 

Instead of the EDIT command. you can use GETDATA O EDITDATA O PUTDATA. 

For more information about GETDATA and PUTDATA, see “The GETDATA and PUTDATA Commands”. 
EDITDATA prompts you for new values for the global variable DATA, exactly as EDIT does. 
EDITDATA, however. does not read data trom file into the active workspace; this means that DATA must 
already exist and must have the correct shape. 


THE PAGES, ROWS, AND COLS COMMANDS 


You can us 
in listings 


the PAGES, ROWS, and COLS commands to specify the arrangement of a file's dimensions 
hese commands affect LIST and LISTDATA. 


Use the PAGES command to specify the dimensions that are to head each page of the listings; the 
ROWS command to specify the dimensions that are to form the listing’s rows; and the COLS command 
the dimensions that are to form the listing’s columns. For example: 


PAGES ‘COUNTRY! 
ROWS ‘DATE ,PRODUCT* 
COLS *PACKAGE* 


or 


PAGES 1 
ROWS 4 
COLS 2 3 
or 
PAGES '' 
COLS 'DATE,PACKAGE' 
ROWS *PRODUCT ,COUNTRY' 


When you specify a dimension 10 PAGES, ROWS, or COLS, this dimension is removed frem its previous 
specification. You needn't associate a dimension with PAGES—in fact, PAGES '' is the default state— 
but you must allow at least one dimension in the rows and at least one in the columns. 
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When you start a MacicStorer session, or when you issue the FILE command, these are the settings 
of PAGE, ROWS, and CO. 


Command Default state 


PAGES empty 
ROWS DATE and all but the last non-DATE dimension 
COLS last non-DATE dimension 

Example 


FILE 'SALES' 
PERIOD 1 80 2 80 
2 DATES SPECIFIED 
PAGES ‘DATE 
ROWS *PACKAGE,PRODUCT* 
COLS ‘COUNTRY! 
LIST 


| UNITED| UNITED| | | | 
| STATES| KINGDOM| GERMANY| CANADA| AUSTRALIA| 


DRAUGHT 
PALE ALE 632 51 145 a1 7 
LAGER 
STOUT 6795 79 220 11 43 
REAL ALE 8 1 
OTTLES 
PALE ALE 239 19 65 77 3 
LAGER 18 
STOUT 223 26 42 82 9 
REAL ALE 15 34 8 6 
CANS 
PALE ALE 245 67 25 24 1 
LAGER 183 
STOUT 227 180 166 22 43 
REAL ALE 51 2 


PAGE 
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THE FROTHY BEER COMPANY PLE QUARTERLY SALES 


UNITED| l | | 
KINGDOM| GERMANY | CANADA| AUSTRALIA| 


PALE ALE 721 45 152 10 7 


LAGER 
STOUT 727 87 200 12 Su 
REAL ALE 7 1 
BOTTLES 
PALE ALE 236 21 69 71 3 


THE TOTAL, AVERAGE, AND NODETAIL COMMANDS 


Use the TOTAL, AVERAGE, and NODETAIL commands to specify dimensions for which certain informa- 
tion is to be calculated and listed, or suppressed. Use the TOTAL command to specily dimensions whose 
totals are to be calculated and listed. Use the AVERAGE command to spec ify dimensions whose averages 
are to be calculated and listed. Use the NODETAIL command to specify dimensions whose averages or 
totals only are to be listed. LIST and LISTDATA are the only commands affected by TOTAL, AVERAGE, 
and NODETAIL. 


For example, both these commands specify that totals are to be calculated for COUNTRY and DATE: 


TOTAL ‘DATE ,COUNTRY' 
or 
TOTAL 4 1 


When you select a file, no dimensions have been specified to TOTAL, AVERAGE, or NODETAIL; that 
is, totals and averages are not calculated for any dimension, and all dimensions’ details are listed. You 
uing the FILE command, or 


can reset TOTAL, AVERAGE, and NODETAIL to their default state by re 
thus: 


TOTAL '' 
AVERAGE '' 
NODETAIL '' 


O command is in effect (which is the default), then averages are calculated only tor nonzero 
values. However, if you set ZERO, zeros are included in calculated averages. For example. if data for 


dimension 2 is 5 0 € 0 7 0. then: 
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NOZERO 


AVERAGE 2 
gives: 
+/Vi+/0#V4" 506070 
6 
but: 
ZERO 
AVERAGE 2 
gives: 
+/VipV 
3 


If you issue the NODETATL command for a dimension for which you haven't also issued the TOTAL 
or AVERAGE command, then MacicSrore acts as if you'd issued the TOTAL command: that is. it gives 
no details and lists only the total for that dimension. 


Examples 


‘These two commands specily that totals are to be calculated and listed for COUNTRY and PACKAGE, 
and that only the total is to be listed for PACKAGE: 


TOTAL 'COUNTRY ,PACKAGE* 
NODETAIL 'PACKAGE* 


‘These next two commands specify that averages are to be calculated and listed for P; 
PACKAGE; and that only the average is to be listed for PRODUCT: 


AVERAGE ‘PRODUCT ,PACKAGE* 
NODETAIL 'PRODUCT* 
THE LIST, LISTDATA, DEPTH, WIDTH, AND OUTFILE COMMANDS 
Use the LIST or LISTDATA command to have a file listed. You can use the DEPTH and WIDTH 


commands to specify the dimensions of the output page. And you can use the OUTFILE command to 
specify the SHARP APL file to which the listing is to be appended. 


The LIST and LISTDATA Commands 


Use the LIST command to get and list data. It combines the GETDATA and LISTDATA commands. 
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Use the LISTDATA command to list the data already in the workspace; it does not read data from 
the file. LISPDATA simply lists the global variable DATA according to the MacicSrore state. DATA 
is usually filled by GETDATA 


Before you use LIST or LISTDATA, you must have properly selected the file and periods to be listed 
You may also have: specified the attributes to be listed, SET; specified how the listing is to be 
arranged, with the PAGES, ROWS, and COLS commands; specified any totals or averages to be calculated 
and listed, or any details to be suppressed, with TOTAL, AVERAGE, or NODETAIL; or specified whether 
zeros are to be produced or suppressed. with ZERO or NOZERO. (You can view all these settings with 
STATE.) 


LIST or LISTDATA appends the listing to any file tied to 99. LISP or LISTDATA automatically resizes. 
the output file as necessary, 


Example 


Sales of bottled ale and stout in the United States, Australia, and Germany in the first quarter of 1980 
are listed: 


PILE 'SALES' 
PERIOD 1 80 

1 DATE SPECIFIED 
‘PACKAGE' SET ‘Bt 
*PRODUCT' SET 'PA,ST! 
*COUNTRY' SET 'USA,AUS,GER' 
PAGES ‘PACKAGE 
ROWS ‘COUNTRY* 
COLS ‘DATE ,PRODUCT* 
TOTAL 'PRODUCT' 
LIST 


THE PROTHY BEER COMPANY PLC: QUARTERLY SALES 


PACKAGE : BOTTLES 


| | PRODUCT | 
PALE ALE| STOUT | TOTAL | 


AUSTRALIA 3 g 12 
GERMANY 65 42 107 


The WIDTH and DEPTH Commands 


Use the WIDTH command to specify how wide you'd like reports and listings to be. Use the DEPTH 
command to specify how deep you'd like reports and listings to be. For example: 


WIDTH 80 
DEPTH 60 
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lhe default state is WIDTH 132 © DEPTH 66. 


The OUTFILE Command 


Use the OUTFILE command to indicate that listings are to be directed to a SHARP APL file and not 
printed at your terminal; and to identify that file. If the file is not tied, MacicSrore ties it; if it doesn't 
exist, MAGICSTORE creates it. 


You can have an OUTFILE listing produced at an I.P. Sharp office, using the HSPRINT facility. For 
example: 


FILE ‘SALES’ 
PERIOD 1 80 TO 4 80 
& DATES SPECIFIED 
OUTPILE 'BEEROUT' 
‘HEEROUT' CREATED AND TIED TO FILE 99. 
LIST 
)PCOPY 1 HSPRINT HSP 
SAVED 18.53.13 12/15/82 
99 HSP 'ERAS ,REMO( LOND) e' 
DELIVERY INSTRUCTIONS: HOLD FOR PICKUP BY MESSENGER FOR: 
==> PRED BLOGGS <== 
STRATEGIC PLANNING DEPARTMENT 
THE FROTHY BEER COMPANY PLC 
NEW FROTHY HOUSE 
RETURN 
REQ.NO 347288 FILED 1234567 22.03.09 12 JAN 1984 


For more information, see “Using HSPRINT for Listings”. 


THE GETDATA AND PUTDATA COMMANDS 


Use the GEPDATA command to retrieve data from a MacicSrore file, and use the PUTDATA command 
to put data from the workspace into the file. (These commands are also used by EDIT and LIST.) 
The GETDATA command reads data from the file and puts it in a global variable called DATA (note 
the underbars: these are part of the name); PUPDATA puts the contents of DATA into the file. 


You can use GETDATA and PUTDATA for data validation and consolidation. You can also use them to 
update MacicSrore files from other files. 


Before vou use GETDATA or PUTDATA, you must have properly selected the file and periods to be 


processed, You may also have: reordered the dimensions, with the ORDER command; or selected only 
certain attributes to be processed, with the SET command. For example: 


Chapter 5: NONCONVERSATIONAL MAGICSTORE 69 


FILE *PRICES* 
PERIOD '1 80 TO 4 80! 
DATES SPECIFIED 
ORDER ‘COUNTRY ,PRODUCT ,PACKAGE ,DATE* 
‘COUNTRY! SET 'UK' 
GETDATA 
PRATA 


ë 


¥ 
7: 


4 
DAPA 


RIOD command specifies that DATA is to contain data for four periods. The ORDER command 
specifies that DAT4’s four dimensions are. in order: COUNTRY, PRODUCT, PACKAGE, and DATE. The 
SET command specifies that the COUNTRY dimension is to contain a single attribute: UX. 


in the example above, the data is scaled up by 100 because 2 was specified as the maximum number 
of decimal places when the file was created. 


DATA can now be manipulated, changed, and if necessary replaced in the file using PUTDATA. 


You can store new data on file using PUTDATA. Extra space is created on the file to allow data for 
new periods, and other attributes not previously stored. Before you use PUTDATA, you must make sure 
that the data is correctly scaled by multiplying the data values by ATTRSCALE. DATA must be integer. 
the car rank (number of dimensions), and shape (size in each dimension). before it is stored on 
ATA, For further information, see “Advanced Concepts and Facilities”. 


file by 


GETLABELS, AND PU?TLABELS COMMANDS 


ITCODES, GETLABELS, and PUTLABELS commands to read imo a SHARP APL 


codesecETCODES eodenos 


codes PUTCOD: 
labels+GETLA#E. 
UT LABE. 


codenos 
codenos 
codenos 


where codes and labels are character matrices, and codenos is an integer vector. The number of 
rows of labels or codes must be the same as the number of code numbers. Code numbers start 
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at | and go up to the total number of attributes on the file. The Frothy Beer Company’s SALES file 
has 12 attributes (numbered 1 through 5 for COUNTRY, 6 through 9 for PRODUCT, and 10 through 
12 for PACKAGE); specifically 


Code number Code 


1 USA 
2 UK 
3 GER 
4 CAN 
5 AUS 
6 PA 
7 LA 
8 ST 
3 RA 
10 D 
11 B 
12 c 


For example 


OC+GETCODES 7 1 10 
LA 
USA 
D 


pc 
(3 8 p'AMERICA PALE ALEDRAUGHT *) PUTCODES 1 6 10 


‘Vhe corresponding labels can be read from file and stored on file using GETLABELS and PUPLABELS, 
using exactly the same syntax as GETCODES and PUTCODES. 


DATA CALCULATION UTILITIES 


MacicSrore includes a set of data calculation utilities. You can use these utilities to express calcula- 
tions with MacicSrore codes when you're modelling or validating data from a MacicStorr file. The 
calculations are on variable DATA, which is read into the workspace by the GETDATA command. The 
extended calculated DATA can be listed with the LISTDATA command. If you extend DATA by adding 
pseudocodes. you cannot store the resultant calculations on file. However, if you use only existing file 
codes as left arguments to the TS command, then you can use PUPDATA to store the contents of variable 
DATA in the file. 


The data calculation utilities are: 


data+codes1 DIVIDED codes2 
divides data for codes1 by data for codes2. DATA must be in the active workspace. 


codes IS data 
assigns data to codes. DATA must be in the active workspace. 


data+codesl MINUS codes2 
subtracts data for codes2 [rom data for codes1. DATA must be in the active workspace. 
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data«codesl PLUS codes2 
adds data for codes1 to data for codes2. DATA must be in the active workspace. 


dim PSEUDOCODE codes 
adds pseudocodes to dimension dim. 


dim REFMT w.d w.d w.d ... 
specifies a new format vector for dimension dim; effective until file reselected. In each element of 
the format specification vector, w is the width of the column for the corresponding attribute; and 
d is the number of decimal places to be allowed the attribute. 


codes RELABEL labels 
applies new labels to codes until file is reselected. 


SUBSET codes 
reduces DATA and resequences attributes. 


data+dim SUM codes 
adds data for codes along dim. DATA must be in the active workspace. 


data+THE codes 
returns data for codes. DATA must be in the active workspace. 


data+codesl TIMES codes2 
multiplies data for codes1 by data for codes2. DATA must be in the active workspace. 


TITLE text 
specifies title to be used for listings until file is reselected. 


codes, codes, and codes?2 are lists of file codes separated with commas; for example: 'UX,USA,PA'. 
codesl and codes2 must be of the same length, and of corresponding dimensions; for example, 
S«'UK,USA,C’ PLUS 'UK,USA,D'. 

data is an APL array with the same number of dimensions as the file, transposed according 
to ORDER. It is a subset of the DATA variable. The number of attributes in each dimension is the same 
as in DATA, except for those dimensions corresponding to codes, codes1, and codes2. 


dim is a dimension name, for example, COUNTRY. 


labels is a list of labels corresponding to codes, with commas separating each label. For example: 
‘GREAT BRITAIN ,UNITED STATES OF AMERICA'. 


For an example of the data calculation utilities, see “A Glimpse of MacicStore”. 


THE APL AND NOAPL COMMANDS 


You issue the APL or NOAPL command to indicate whether you're using an APL terminal. APZ is in 
effect when you load MacicStore. 


If you issue NOAPL, the LIST and LISTDATA commands substitute ASCII characters for some APL 
characters; for example, / for | . 
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Chapter 6 


USING MAGIC 


‘This chapter describes how you can use I.P. Sharp’s time series manipulation language Macic with 
MacicSrorr files. Some knowledge of Maaic is assumed. For more information about Macic, see the 
MAGIC User’s Manual. 


If you want to use Macic to manipulate a MacicSrore file, you should: load Maaic; get MacicSrorr; 
and tie the MacicSrore file and create the access functions, thus: 


)LOAD 39 MAGIC 
SAVED 22.10.12 01/31/83 
LINK fileid 


where: fileid identifies a MacicSrore file. LINK creates a Macic access function with the name 
fileid. Use this access function to read data from the MacicStore file; the access function automati- 
cally ties the correct MacicSrore file, and can be used independently of or in conjunction with other 
Macit access functions. (Macic is available in several public workspaces; for a list, see the Public 
Workspaces Catalogue.) 


Now enter: 


AUTOLABEL 
CLEAR 
frequency DATED dates 


frequency must be one of: DAILY, WEEKLY, MONTHLY, QUARTERLY, SEMI, YEARLY, or, for 
GENERAL files, n PERIODS, where n is the number of periods in a year. The Macic frequency you 
specify to DATED must be the same or lower than the frequency specified for the file when it was 
created. For example, you can access MONTHLY data as any of: MONTHLY, QUARTERLY, SEMI, or 
YEARLY, but not as WEEKLY or DAILY. For more information, see “Timepacking”. So now enter: 


PUT file ‘codes' 
where codes are character codes separated by commas, blanks, or slashes. For example: 

PUP SALES ‘GER,USA/LA,PA/B* 
This statement retrieves data from the file called SALES, and, because AUTOLABEL is set, also constructs 
appropriate labels from the attributes chosen. GER, USA, LA, PA, and B are some of the codes defined 
when the file was created 
This is an example of a TIMESERIES report: 

LINK 'SALES' 

AUTOLABEL 

NOYEAREND 


QUARTERLY DATED 1 80 TO 4 80 
'H' DISPLAY SALES 'C,UK* 
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3RD/80 


UNITED KINGDO! 


PALE ALE 75 70 71 
LAGER 195 181 207 
STOUT 179 173 158 
REAL ALE 47 50 52 


None of the SO5UCP codes was specified in this access. By default. the Macic access function assumes 
you want all of them and effectively tags all on to the end of the right argument to SALES. ‘he same 
report could have been generated using FUT SALES 'C,UK,PA,RA,LA,ST'. 


‘Vo display the directory of a MacicSvore file in a Macic workspace you can give 'DIRECTORY' 
as the right argument to the Magic access function for the file. For example: 


SALES 'DIRECTORY' 


You should notice that the sequence of codes determines both the indentation of the dimensions in the 
rows of the display and the sequence of the attributes. 


Specifying AUTOLABEL causes reports to be produced using the attribute labels specified when the file 
was created 


Timepacking 


Using Macc, you can retrieve MacicSrore data using a different frequency from that specified for 
the MacicSrore file. For example, you can retrieve data in a quarterly or yearly format from a 
monthly MacicSvore file. This compression of the data is called timepacking. The data is usually 
summarized by totalling the packed periods; for example. a quarterly report would sum the three 
months that make up the quarter. 


MacicStorr allows you to specify how MacrcSrore data is to be compressed by Macic; these are 
called automatic calculations. You can specify these calculations: 


You can specity a different calculation for each attribute of a dimension. For example, if you have 
a file of stock quotations with daily high, low, and closing prices, you would want to specify the 
automatic calculations as MAXIMUM, MINIMUM, and LASTVALUE, respectively, to give consistent reports 
when the file is accessed with a weekly, monthly, or quarterly frequency. 


MacicSvore introduces into the Macie workspace a new state, 
This state indicates whether automatic calculations are to be performed when 


As part of tmepackin 
AUTOCALC/NCAUTOCALC. 
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data from a MacicSvorr file is compressed over time; for example, when a quarterly file is accessed 
with a yearly timeframe 


You set or reset automatic calculations with the CA suboption of ALTER. 


Order of Dimensions 


‘The order in which you specify the codes (in the right argument to the file access function) affects 
the order in which data is displayed in your report. If you issue the WOTIMESERIES command, the 
last dimension for which you specified codes is put in the columns. All attributes of other dimensions 
are assigned to the rows. For example: 


CLEAR 

COLWIDTH 10 

NOTIMESERIES 

QUARTERLY DATED AT 1 80 

HIGHLIGHT 

TITLE ‘SALES OF PALE ALE 1980 JANUARY-MARCH* 
AUTOLABEL 

DISPLAY SALES 'PA,B,C,D,B+C+D,UK,CER,USA,AUS' 


SALES OF PALE ALE 1380 JANUARY-MARCH 


| UNITED| | UNITED| 
| KINGDOM| GERMANY| STATES | AUSTRALIA 
PALE ALE 
BOTTLES 19 65 239 r] 
CANS 67 25 245 1 
DRAUGHT 51 145 632 7 
B+C+D 137 235 1,116 11 


If you specify only one code for a particular dimension, then this dimension is displayed before the 
others. For example, SALES 'PA,LA,RA, B, UK,USA' has a single code B {for BOTTLES) in the 
PACKAGE dimension. This access is displayed in the same format as 5. S'B, PA,LA,RA, UK,USA'. 
Using DISPLAY, labels for successive dimensions are indented two s . If you specify NOTIMESERIES 
and the dimension with only one entry in the last dimension, this single attribute appears as a single 
column of the display. 


À 
Zi 
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Overridding Al/TOLABEL 


If you give a text left argument to the Macic access function, this is used to replace selectively the 
ample: 


automatic labels. For e 


DISPLAY 'KEG,,,,,,,AMERICA' SALES 'D,PA,RA,LA,ST,UK,GER,USA,AUS' 


4TH/82 
KEG 

PALE ALE 
UNITED KINGDOM 55 
GERMANY 157 
774 
7 

REAL ALE 
ED KINGDOM 8 
109 
234 
807 
54 


‘This replaces the default labels DRAUGHT and UNITED STATES by KEG and AMERICA respectively. 
Each comma in the left argument corresponds to a code in the right argument. Default labels are not 
overwritten where there is nothing in the left argument between the appropriate commas. 


Calculated Items 


You can combine codes of the same dimension with the following arithmetic symbols: 


atw Adds data for code a to data for code w 
a-w Subtracts data for code w from data for code a 
axis Multiplies data for code a by data for code w 


atu Divides data for code a by data for code w (making the result zero for 
a where data for code w is zero) 


a as a percentage of w 


ate 


Calculations are evaluated right to left as in the usual APL order of execution 
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Examples 


Data for UX, USA, and GER is summed. The PRODUCT and PACKAGE codes are not given, so all 
attributes of these dimensions are extracted: 


DISPLAY SALES 'UK+USA+GER" 


Data for the UX, USA, and GER is displayed as a percentage of the total sales for these three countries: 


DISPLAY SALES 'UK:UK+USA+GER ,USA:UK+USA+GER ,GER:UK+USA+GER" 


Data for various countries is summed, and default labels are replaced—such as “UK+GER” with 
“EUROPE”: 


DISPLAY ‘WORTH AMERICA,EUROPE ,WORLD' SALES 'USA+CAN ,UK+GER ,UK+GER+CAN+ 
USA+AUS' 


Plotting with SUPERPLOT 


To produce simple plots, follow the procedure given above for generating reports, but replace 
DISPLAY with PLOT. 


You can also use I.P. Sharp’s business graphics package, SupeRPLor. For full details, see the SUPER- 
PLOT User’s Guide. 


For example: 


)LOAD 39 MAGIC 

SAVED 22.10.12 01/31/83 
LINK 'SALES" 
CLEAR 
QUARTERLY DATED AT 4 82 
ASUPERPLOT 'TERM,HP7221;TYPE,PCS;COLOUR,1,2,3,4!' 
ASUPERPLOT 'OBS,RIGHT ,HOR,1,PERCENTAGES ;2,PERCENTAGES' 
ASUPERPLOT ‘OBS ,RIGHT ,HOR,3,PERCENTAGES ;4,PERCENTAGES' 
ASUPERPLOT ‘TITLE,1,THE FROTHY BEER COMPANY PLC! 
ASUPERPLOT ‘TITLE,2,SALES IN THE UNITED KINGDOM‘ 
ASUPERPLOT ‘FONT ,TITLE,1 1.5" 
LABEL ‘PALE ALE,REAL ALE,LAGER,STOUT' 
PLOT SALES ‘UK,C+B+D,PA,RA,LA,ST" 
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THE FROTHY BEER COMPANY PLC 
SALES IN THE UNITED KINGDOM 


GMM PALE ALE 
WM REAL ALE 
GH LAGER 
MN Sour 


39.63% 


4/82 
QUARTERS 
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Chapter 7 


ADVANCED CONCEPTS AND FEATURES 


Event Trapping 


In nonconversational mode, all MacicSrore-generated errors are trappable with SHARP APL’s 
event-trapping facilities. For every one of the errors that it issues, MacicSrore signals a unique event 
number. For example, if you specify an invalid period to the PERIOD command, MacicSror: signals 
event 608. You can use this event number for validation when you write a SHARP APL application 
that incorporates a MacicStore file. See “MacicStore Events” for a complete list of MacicSrore- 
generated event numbers. 


Identifying MacicStorr Files 


Component | of a MacicSrorer file always contains only the seven-character vector WIZARD3. For 
example, this proves that MAYBEMAGIC is a MacicSrore file: 


'MAYBEMAGIC' DSTIE 100 
‘WIZARD3'=[)READ 100 1 


DATA ENTRY AIDS 

When you're editing a MacicStorr. file (that is, when you're entering data), you can in fact enter 
any SHARP APL expression that evaluates to a number. This means that you can enter, for example. 
+/34.6 23 12.78; it also means that you can use user-defined functions—as long as they have 
explicit numeric results. You could certainly code such functions yourself, but the rest of this section 
discusses the use of such functions from Stars. 


You can use the Stars data specification aids when MacicStore prompts you for data. These are 
particularly handy when you're entering repetitive or easily derived data. For example, instead of this: 


16 17 18 18 18 18 18 18 18 
you could enter this: 


16 17 THEN 18 


You can use the Srars data specification aids whether you're in conversational mode (having selected 
the UPDATE or AMEND option of the WIZARD program) or in nonconversational mode (having issued 
the EDIT command). However, you can’t use these aids in the same workspace as Macic, because 
their respective function names conflict. 


To use the Srars data specification aids, copy the group DSA from workspace 588 STARSUTIL helore 


you issue the WIZARD or EDIT command: 


)PCOPY 588 STARSUTIL DSA 
SAVED 19.22.19 03/09/82 
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‘The Stars data specification aids are: 


BY 
DEFLATED 


INFLATED 

OF 

THEN 
'IMES 

TO 


These functions are self-documenting. 


USING HSPRINT FOR LISTINGS 


The alternative to printing reports at your terminal is to use the HSPRINT facility to have them printed 
at an I.P. Sharp office. This feature is useful for printing large reports that would take a considerable 
amount of time (and accumulate substantial character charges) if they were printed at a terminal. 
Another advantage of HSPRINT is that it does not suffer from line noise, which can be a nuisance 
with lengthy reports printed at the terminal. Using HSPRINT is also considerably cheaper than listing 
data at the terminal. Its only major disadvantage is the delay before you receive the reports, so you 
shouldn’t use HSPRINT if you need fast turnaround. 


In order to tell MacicStore that you want listings prepared for the HSPRINT facility, issue the 
OUTPILE command. If MacicStore’s LIST command (or conversational WIZARD) detects that a listing 
is destined for a file instead of your terminal, MacicStore inserts the appropriate HSPRINT control 
messages into the output; thus page skipping is handled properly. MacicStore also traps FILE 
FULL events and resizes the output file. You should also make sure that the WIDTH command is not 
set to a value higher than 132; in other respects, you set the workspace’s state just as you would for a 
terminal listing. ZIS? and LISTDATA append data to any file tied to 99. 


When the listing’s complete, you can copy and execute HSPRINT’s HSP function, which submits the 
print request for you. 


For example: 
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FILE 'SALES' 
PERIOD 1 80 TO 4 80 
4 DATES SPECIFIED 
OUTFILE ‘BEEROUT* 
‘BEEROUT' CREATED AND TIED TO FILE 99. 
LIST 
)PCOPY 1 HSPRINT HSP 
SAVED 21.36.49 09/24/82 
99 HSP 'ERAS,REMO(LOND)o* 
DELIVERY INSTRUCTIONS: HOLD FOR PICKUP BY MESSENGER FOR: 
==> FRED BLOGGS <== 
STRATEGIC PLANNING DEPARTMENT 
THE FROTHY BEER COMPANY PLC 
NEW FROTHY HOUSE 
RETURN 
REQ.NO 47288 FILED 1234567 22.03.09 12 JAN 1983 


‘The right argument to HSP can vary considerably. Consult SHARP API. Technical Note 08 
“HSPRINT” 


MANIPULATING MAGICSTORE DATA WITH SHARP APL 
Getting Data from File 


You can access any MacicStore file directly with the GETDATA command. GETDATA reads data into 
the active workspace for specified periods and attributes. 


You should use GETDATA with the FILE, PERIOD, ORDER, and SET commands; for example: 


FILE 'SALES* 

PERIOD 1 79 TO 4% 80 
8 DATES SPECIFIED 

ORDER 1 2 3 4 

1 SET123 

2 SET 4 2 

3 SET 3 1 

GETDATA 


In the example above, a four-dimensional file (three dimensions plus DATE) is accessed. The data is 
read into the global variable DATA. DATA’s rank is always the same as the number of dimensions on 
the file: 


epDATA 
4 

pDATA 
3228 


The data is transformed according to ORDER and SET (you can reset both these commands to their 
default values by reissuing the FILE command). The number of periods represented in DATA is the 
same as the number of periods you specified to the PERIOD command. This is true even if some of 
these periods do not exist on the file; for these periods, zeros fill DATA. In fact. you can use GETDATA 
on a newly created file that has no data at all (that is, has no periods stored). 
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The variable DATA must be integer. To scale it to the number of decimals allowed for the file, you 
need to divide it by APTRSCALE. For example. for the Frothy Beer Company's PRICES file, 
ATTRSCALF is 100. 


Putting Data to File 


You can use the PUTDATA command to update MacicSrore files from non-Mac 
data can be overwritten and new data added to a MacicSrorer file using PU 


Srore files. Existing 
TA. 


You should use PUTDATA with FILE, PERIOD, ORDER, and SET commands. Both GRDER and 
SET have their default values after a file is selected using FILE. 


PUPDATA uses the variable DATA to update the file. This variable must be in the shape defined by 
PERIOD, ORDER, and SET. For example, if you have a file which has ten products, twenty countries, 
and is monthly, and if you specify PERIOD 1 78 TC 12 78 andORDEP ‘PRODUCT ,COUNTRY ,DATE', 
then pDATA must be 10 20 12. If you use SET, then this will reduce the size required for DATA 
and possibly change the order of the attributes. For example: 


‘PRODUCT' SET 2154 
This will reduce the number of products to four. chosen in the given order; the shape of DATA must 


now be 4 20 12. PUTDATA will update the data on file for the second, first. fifth. and fourth products 
for the specified timeframe. The other products will remain as they were before. 


Scaling 
DATA is always integer. If the file allows you to enter numbers with any decimals. you will have to 


scale up DATA by the value of APTRSCALE before storing it with the PUTDATA; lor example, 
DAT A-L RAWDATAxATTRSCALE. 


“The number of decimal places determines the scaling of the data stored in the file. If the maximum 
number of decimals is 3, then all numbers entered are multiplied by 1000 before they're stored in the 
file as integers. For example. with maximum number of decimals as 3. the numbers 1.234, 56. and 
23.45 are stored as 1234. 56000, and 23450. Data is also retrieved in this sealed-up form and 
converted before display. You only see numbers with decimal places when you enter them at the 
terminal or jist them. ‘Fhe scaling of data is particularly important when you are updating 
MaciceSvore files from other files or when you are reading MacicSroré files to manipulate raw data 


When retrieving the same data using the function GETDATA, you need to divide DATA by ATTRSCALE 


to convert it back to decimal. MacicSvore stores all numbers as integers to reduce the amount of 
file space. An integer number requires only half the space required to store real (decimal) numbers. 
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MATRIX DEFINITION OF CODES 
You can define a file’s attribute codes by way of a matrix, rather than entering them by hand. For 
example: 


CODE (1) : aMYCODES 


where MYCODES is a character matrix you've already defined. The matrix you define must be of the 
shape m n, where m (the number of rows) is less than or equal to the number of codes required; 
and n is greater than or equal to the length of the longest code. Each row must contain one code, 
right-padded (if necessary) with blanks. Codes cannot contain internal blanks. 

You can also use the built-in character matrix DEFAULT to assign codes in the form 41, A2, A3, ete- 
CODE1 (1) : DEFAULT 


You can also use GETCODES and PUTCODES to change codes under program control; for more informa- 
tion about this, see “l'he GETCODES, PUTCODES, GETLABELS, and PUTLABELS Commands”. 


LOGGING USE OF MAGICSTORE FILES 
‘The MacicSrorr command FILE ties the specified MacicSrore file, and unpacks that file’s directory 
component (component 3). If a function LOG is in the directory component, it is executed. This function 
can be used to record the use of a MacicSrore file you have given other users access to. For example, 
if user 1234567 has created MacicSrore file SALES, and wants to log use of this file by appending 
the name of the file to a file 1234567 JOURNAL, this is his procedure: 
1 He writes the LOG function. For example: 
V LOG;T 
(1) "1234567 JOURNAL’ OSTIE T+1+l/0,0NUMS © FILE DAPPEND T © DUNTIE T 
v 
FILE is a global variable containing the name of the selected MacıcSrore file. 


2 He creates the logging file and gives universal DAPPEND access to it: 


'JOURNAL' (CREATE 1 
(1 3p 0 8 0) QSTAC 1 


3 He then stores function LOG in the directory of file SALES: 


FILE '1234567 SALES' 
WRITEDIR 'LOG' 


Function LOG appends the name of the SALES file every time the file is selected. User 1234567 can 


then find out when and by whom SALES is used by reading the control information of JOURNAL’s 
components. For example: 
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‘JOURNAL QSTIE 1 

)PCOPY 1 FILEAID TIME 
SAVED 14.07.47 03/13/81 

‘USER ',¥1t14DRDCI 1 1 
USER 7654321 

‘USED AT ',TIME ~1+QRDCI 1 1 
USED AT 06/18/84 14:33:50:57 


gives the user number and timestamp of the first component appended to file JOURNAL. If there is 
an error in the LOG function, MacicSrore exits the ZOG function, and continues normally. 
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Chapter 8 


FILE DESIGN 


PARTITIONING DIMENSIONS 


Alb MacicSrore files are partitioned by DATE. If you enter DATE as the only partitioning dimension, 
MagicSvork calculates the number of periods that it can store in a data component-—the calculated 
blocking factor for DATE. 


*You can specify one or more dimensions other than DATE. If you do, DATE is assumed to be the 
partitioning dimension with the calculated blocking factor. You are prompted for a blocking factor 
for each partitioning dimension you specified. MacicSrore calculates and displays how many 
periods it can store in each data component 

“You can specify 'E and one or more other dimensions. You must select one of these dimensions 
to have the calculated blocking factor. You enter blocking factors for the others. 


e Specifying non-LATE dimensions: 


TON(S) (DEPAULT=DATE): COUNTRY 
S) FOR-COUNTRY : 5 
120 (120.00) OK (Y/N)? : YES 


Specify the dimensions that you want partitioned. Choose dimensions from which you will usually set 
only one attribute. If you are likely to set several attributes of a dimension, try to make sure that those 
atributes are adjacent in the file. 


* Specifying DATE and non-DATE dimensions: 


PARTITION DIMEN. 


W(S) (DEPAULT=DATE): COUNTRY , PRODUCT , DATE 
WI. L CALCULATE THE BLOCKING FACTOR FOR ONE DIMENSION 
WHICH D TON: COUNTRY 

BLOCKING FPACTOR(3) FOR-PRODUCT,DATE: 4 20 

NO. OF CGUNTRY/BLOCKS IS 30 ( 30.00) OK (Y/N)? : YES 

NEW DATABASE 'SALES' CREATED 


COUN 


Because COUNTRY was chosen as the partitioning dimension to have a calculated blocking factor, the 
last prompt indicated that data for as many as thirty countries can be stored in each data component. 


You may know exactly how many periods you want stored in each data component (for example, 16). 
Allow DATE as the partitioning dimension, but if the calculated blocking factor is less than you want, 
enter N at the NO. OF DATE/BLOCK prompt, and sclect DATE and another dimension as the parti- 
tioning dimensions. ‘Then select the non-DATE dimension to have the caiculated blocking factor. 


Your selection of partitioning dimensions depends on the size of the file and how you intend to use 
it. For example, if the file has data for ten countries, but ninety percent of the retrievals are for all 
products in one country, then choose COUNTRY as the dimension on which the file is to be partitioned. 
If, on the other hand, most retrievals are for only one product in all countries, then choose 


PRO, 


PRODUCT as the partitioning dimension. The rest of this chapter discusses file design in detail 
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CONSIDERATIONS 
The Data Package 


MaaicStore employs two methods of file storage that minimize costs. One of these is 10 scale data 
so that all numbers are stored as integers. The other is to use a sparse data storage technique. 


A file’s scale is defined when the file is created; specifically, at the prompt MAX. NUMBER OF 
DECIMAL PLACES. For example, if you respond 2 to this prompt, MacicStore multiplies all input 
numbers by 100 (that is, 10*2): 14.56 is stored as 1456, and 15 as 1500. A real number (that is, a 
number with nonzero decimal places) takes eight bytes of storage; but an integer (that is, a “whole 
number”) takes only four. Storing data as integers therefore cuts file storage costs in half. 


The sparse data storage method stores the data as two variables in a package in each data component, 
instead of as a single variable. he package comprises: a vector of nonzero numbers; and a boolean 
mask. For example, MacicStore stores 1234 0 0 0 4567 0 0 0 6789 0 O as 1234 4567 
6789 and 10001000100. The boolean vector (that is, the variable containing only 
Ps and 0's) takes a tiny amount of file space; thus the overall amount of file space required is greatly 
reduced. The sparse data technique is transparent to a MacicStore file’s users, but it is a very 
important consideration in some file applications. 


Partitioning the File 


MacicSrore allows you to store as a file what amounts conceptually to a very large numeric array 
of rank 2 or greater. So that the file can accommodate very large arrays, MacicSrore partitions it 
into manageable blocks of data. Each of these data blocks contains around 7,200 values, and is stored 
in a single file component. (A MacicSrore file has: an identification component, component 1; 
directory component, component 3; code component, component 4; label components, components 
5 to 30; and data components. Data components contain the data blocks. (See “MacicStore File 
Organization” for details.) Haw MacicStore partitions a file into these blocks is of great importance 
to the creator of a file, because the cost of editing and listing data is directly related to how many 
data components are accessed. The best file structure is the one where the fewest components are 
accessed in the most popular type of access. 


A small file is usually partitioned along the DATE dimension only (default partitioning). This means 
that each data component on file for such a file has a fixed number of periods. In the Frothy Beer 
Company’s SALES file, we chose to store forty quarters in each data component. So the first forty 
periods stored on file are in the first data component, the next forty. in the second, and so on. 


Larger files are partitioned along the DATE dimension and one or more other dimensions. With 
MacicSrore, the only file design you have to do is to select this other dimension (or dimensions), 
and then to decide how many attributes of this other dimension and how many periods are to go into 
each data component. The more of one there is in a component, the less room there is for the other. 
The tradeoff between this dimension and DATE reduces to the question of how many periods you want 
to store in each data component. 


‘There are no inversions of the data; that is, the data is only stored once. ‘Therefore, the onus is on 


the creator of a file to choose a structure that’s relatively cheap for most major applications of the 
file. 
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How Files Are Used 


A file may be accessed in a variety of ways. The key feature of any access is the number of periods 
accessed. Typically, a MacicSrore file is accessed: 

© to edit the data (often only one period) 

o to list data that has recently been entered 

e to analyse a section of input data over many periods 

o to analyse all periods, and forecast data into the long term 


For example: a monthly sales file is updated with the latest sales figures every month. These figures 
are immediately listed in various formats as management reports. Also, regular analytical reports on 
the company’s sales over the last 12 months and year to date are produced, showing actual sales and 
their variance from plan. Later on, further analysis is done over the entire file, and projections are 
made of future sales. 


Each of the access modes has a file organization most suited to it. Choosing one organization makes 
one group of users happy because their access is particularly cheap; but all others are less well off. 
The best file design reduces overall accessing cost to a minimum without creating an undue cost penalty 
for any major user of the file. 


‘The creator of the file should consider the relative frequency of each mode. The most frequent activities 
should be considered as major and the least frequent as minor. With most files, the input of data is 
much less frequent than data retrievals. Consequently, it is sensible to make data retrieval cheap even 
at the expense of editing. 


If you choose to make one access mode cheap, you may find that there are many groups of users in 
this category, each group with its own, incompatible requirements. For example, there may be several 
groups of users interested in data analysis, each with its own particular slant on the data. Let’s say 
that a company has a sales file with monthly data by PRODUCT and REGION: the product managers 
will want to access their products singly across all regions; but the region managers will want to know 
what’s happening in their regions only. If it’s necessary to partition the file along a dimension other 
than DATE, the creator of the file will have to choose between these two groups. If the file is partitioned 
by PRODUCT, then accessing one product is cheap and many products relatively expensive. This is to 
the advantage of the product manager—who is interested in his single product—but not to the region 
manager, who has to access ali products to get the total picture of his region. The opposite occurs 
if the file is partitioned by REGION. 


Costs 


‘The cost of accessing a file has two parts—overhead and incremental: 

+ The overhead is the fixed cost of any access, regardless of the amount of data got or put. (Overhead 
increases with the number of partitioning dimensions.) 

+ The incremental cost is that part of the access cost that’s sensitive to the amount of data got or 
put; in MacicSrore’s case, the incremental cost is proportional to the number of data components 
read, appended, or replaced. 


The overhead is relatively small. Thus an access of forty data components is nearly twice as expensive 
as an access of only twenty components. 
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File Size 


First, you should count up how many dimensions the file has, and how many attributes each dimension 
has. For example, in the Frothy Beer Company’s SALES file, there are four dimensions: COUNTRY, 
PRODUCT, PACKAGE, and, necessarily, DATE (quarterly periods). The COUNTRY dimension has five at- 
tributes: UNITED STATES, UNITED KINGDOM, GERMANY, CANADA, and AUSTRALIA, the PRODUCT di- 
mension has four attributes: PALE ALE, LAGER, STOUT, and REAL ALE; and the PACKAGE dimension 
has three attributes: DRAUGHT, CANS, and BOTTLES. (The attributes of the DATE dimension are the 
periods.) 


Secondly, you should think about how the file may grow in the future, and, in particular, how many 
auributes are likely to be required for each dimension. If you multiply the number of attributes for 
each dimension together, you get the number of data values that are stored for each period. For 
example, if there are ten, twenty, and five attributes of COUNTRY, PRODUCT, and PACKAGE, respectively, 
then there are a thousand values for each period. Since MacicSrore stores 7,200 values in each data 
component, the number of periods stored per component is easily calculated: in this case it is seven 
(that is, L7200#1000) 


If you think that the possible number of attributes of a particular dimension is very high—or 
indefinite—then you should partition the file on this dimension. This is the best way to handle 
dimensions for which the number of attributes is likely to grow considerably. Otherwise, a lot of 
redundant space is required in each data component for expansion. Adding attributes to a partitioning 
dimension causes MacicSrore to append new data components to the file, rather than putting more 
information in the existing components. 


Thirdly, you should consider how many periods in total will be stored on the file. For example, you 
may have a rolling 24-month file, which means that there are always 24 periods; a daily file may have 
several hundred periods, going back many years; a yearly file may have only four or five periods. The 
number of periods stored on file should be compared with the number of periods stored in each data 
component. For example, if 5 periods are stored in each data component, and you anticipate that data 
for only 12 periods is to be stored, then this data will occupy three data components ([12+5). 


If the file uses fewer than four data components (that is, if it has fewer than 28,800 possible values 
and they can conveniently be partitioned into groups of no more than 7,200 values each), then you 
should partition the file only by date (default partitioning). If you expect that the file will eventually 
need more than three or four data components, you should consider partitioning the file on a dimension 
in addition to DATE. By partitioning the file along another dimension, more periods can be stored in 
each component, thus making access over many periods less expensive. Specifically, you should partition 
the file on a dimension for which you specify few attributes in a typical access. For example, if you 
most often access a file for many periods but for only one COUNTRY at a time, you should partition 
the file on COUNTRY. 


Sometimes you have to partition a very large file along two or three dimensions as well as DATE. 


THE DESIGN DECISIONS 


Choosing the best organization for a MacicStore file can be reduced to three design decisions: 
1 Default partitioning (that is, by DATE only)?—YES or NO 

If NO: 
2 Which dimension to partition on? 
3 What blocking factor (that is, how many periods per data component)? 
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Use default partitioning if the file will use no more than four data components (that is, if it won’t 
have more than 28,800 values); or if the most popular type of access is over few periods. 


Use nondefault partitioning: 

o for a large file (that is, one with more than 28,800 values, or one in which default partitioning 
causes more than four data components to be accessed typically); or 

o for a small file that has a dimension that will considerably increase in size. 


If you use nondefault partitioning, the partitioning dimension should be either: 

1 A dimension for which few attributes are specified in a typical access. For example, if you had 
a file with a hundred PRODUCT attributes and twenty COUNTRY attributes; and for most listings 
you only used one. two, or three COUNTRYs but all PRODUCTs, then partition the file on 
COUNTRY. Or 

2 A dimension whose attributes will greatly increase over time; for example, if the number of 
COUNTRY attributes will increase from twenty to sixty over the life of the file. If this conflicts with 
point 1, then consider partitioning on both dimensions with a large blocking factor on the growing 
dimension. 


You should choose a blocking factor such that the number of periods in each data component is similar 
to the number required for the most common access. For example, if you generally access a file over 
i2 months, then allow at least 12 months in a data component; possibly as many as 24. 


If the file is partitioned on two or more dimensions, then specify one large blocking factor and the 
others small (usually 1 for ali but one dimension). The product of the blocking factors will remain 
constant for a given number of periods on file. For example, if you were partitioning on both 
PRODUCT and COUNTRY, the blocking factors could be 4 5, or 2 10, or 1 20, or 20 1. The blocking 
factor should not be greater than the number of attributes in a dimension. If there are only ten 
COUNTRY attributes, then there is no point in having a blocking factor of 20 for this dimension (unless 
you expect it to grow to 20). 


EXAMPLES 
Case 1: The Frothy Beer Company’s SALES File 


Frequency: quarterly 
Shape: 


Dimensions Attributes 


COUNTRY UNITED STATES 
UNITED KINGDOM 
GERMANY 
CANADA 
AUSTRALIA 
PRODUCT PALE ALE 
LAGER 
STOUT 
REAL ALE 
PACKAGE DRAUGHT 
BOTTLES 
CANS 
DATE 24 (that is, six years) 
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In this example, there are 1,440 values stored on file (5x4x3x24). A single MacicSrore data 
component holds up to 7,200 values, so this file fits easily into a single component. Consequently, 
default partitioning should be allowed. 
Case 2: The Frothy Beer Company’s SALES File—Extended 
If the number of auributes is increased: 

COUNTRY: 10 (space for 5 more countries) 

PRODUCT: 10 (space for 6 more products) 

PACKAGE: 5 (space for 2 more packages) 
There would now be a possible 12,000 values. With default partitioning, all this data would fit into 
two data components, each with as many as 14 periods. ‘Therefore, default partitioning is still best. 


Case 3: A Monthly Version of the Frothy Beer Company’s SALES File 


Frequency: monthly 


Shape: 
Dimensions Attributes 
COUNTRY 10 
PRODUCT 10 
PACKAGE 5 
DATE 72 (that is, six years) 


‘There would now be a total of 36,000 values. If default partitioning is allowed, this would use six 
data components, each with ten periods. 


However, the aim is not to access more than four components in the usual or typical access. Because 
there are six components, it is important to consider how many periods are used in the most popular 
access modes: 

* Few periods. Let’s say that the file is predominantly used for all attributes of PRODUCT, PACKAGE, 

and COUNTRY, but for only 24 periods {that is, two years). In such a case, default partitioning 
causes only two components (each with 14 periods), to be accessed. Consequently, default 
partitioning is still the most efficient. 
Many periods. Let’s say that the file is predominantly retrieved over all periods. In this case, default 
partitioning causes all six data components to be accessed. With this pattern of usage, you should 
consider nondefault partitioning; for example, with a blocking factor of 1 on any of the 
non-DATE dimensions. Which dimension you choose to partition the data on should be the dimension 
most often accessed with a single attribute. 
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Case 4: Currency Exchange Rate File—Daily 


Frequency: daily 
Shape: 


Dimensions Attributes 


MARKET LONDON 

NEW YORK 

PARIS 

ZURICH 

TORONTO 

VIENNA 

COPENHAGEN 
CURRENCY AUSTRALIAN DOLLAR 


US DOLLAR 

STERLING 

SWISS FRANC 

(15 currencies altogether) 
FEATURE SPOT 


1 MONTH FORWARD 
2 MONTH FORWARD 


24 MONTH FORWARD 
(8 features altogether) 
DATE as many as 2,500 (that is, ten years) 


This file is potentially a monster of 2,100,000 possible values in three hundred data components. In 
reality, the file will be quite sparse, since some minor currencies and markets will have much less data 
reported than major markets and currencies. The sparseness is a leading consideration in choosing the 
way the file is partitioned. (Case 6, below, shows a radically different approach.) This file needs to 
be partitioned on one or two dimensions as well as DATE. The first thing to consider is how the file 
will be accessed. If we assume that the typical user will look at one MARKET at a time, then the file 
should be partitioned by MARKET. If the most popular type of access is of many attributes of 
CURRENCY and one FEATURE, then the best blocking would be 1 each for COUNTRY and FEATURE, 
which allows all 15 attributes of CURRENCY and 480 periods in each data component. 


Case 5: Currency Exchange Rate File—Monthly 


Frequency: monthly 


Shape: 
Dimensions Attributes 
MARKET [see case 4] 
CURRENCY [see case 4] 
FEATURE [see case 4] 
DATE 120 (that is, ten years) 
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Because there are 480 periods per component in the daily version of this file (case 4, above), but only 
120 periods in total for this version, you should use an alternative blocking scheme. The chief 
alternatives are: use a higher blocking factor on FEATURE; or not partition on FEATURE at all. A 
blocking factor of 4 for FEATURE and 1 for MARKET allows 120 periods per component. Not blocking 
on FEATURE allows 60 periods in one data component. 


Case 6: Currency Exchange Rate File—Daily—Alternate 


In case 4, there are 15 currencies for 7 markets. Each currency has 8 possible features, making a total 
of 840 possible time series. In reality, data is reported in different detail in each market, the important 
markets and currencies having more detail than the less important ones. Of the possible 840 time series, 
only 200 may be used. Using the file structure in case 4 would mean that most of the data would 
not be entered and would therefore effectively be zero on file. The file in this case is 75% sparse. 
MacıcSrorrk has a sparse data storage scheme which caters to this type of data. However, you should 
also consider storing the data as two hundred time series. Each time series would be for a single 
combination of market, currency, and feature. 


With such a scheme, the file should be blocked by time series, such that you have up to around 720 
periods per block (a blocking factor of 10). To improve the efficiency of access, it's a good idea to 
use dummy time series as fillers; these ensure that groups of time series that are often accessed together 
are in the same component. For example: 


First data component: 
NCANSPOT Spot price, Canadian dollar, New York 


NCAN1 1 month forward 
NCAN2 2 months ferward 
NCAN3 3 months forward 
NCAN6 6 months forward 


NCAN12 12 months forward 
NCAN24 24 months forward 
FILLER. 
PILLER2 
FPILLER3 


Second data component: 
NUKSPOT Spot price, British pound, New York 
NUK1 1 month forward 
NUK2 etc, 


Here the fillers pad out the data so that the NUK series doesn’t span two components. The fillers can 
be replaced by time series for currencies that are reported in less detail. For example, if there is only 
one time series for a particular currency traded in New York, this could occupy the position of 
FILLER1. However, if you want to allow for future expansion of the file, using fillers means that 
additional time series can be put in each data component. For example, if a series called NCAN9 is 
to be added, it could be used in place of FILLER1. 
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Appendix A 


MAGICSTORE FILE ORGANIZATION 


Component 1—Identification Component 


Component 1—the file’s identification component—contains the seven-character vector WIZARD3, 


Component 2 


Component 2 is reserved for future use. 


Component 3—Directory Component 
Component 3—the file’s directory component—contains a package of variables, all of whose identifiers 
are prefixed with ATTR or SATTR. These variables define the shape of data on file, and relate file 


components to periods and data attributes. 


A directory component contains a package of these variables: 


ATTRCALC ATTRCALCDIM ATTRCOMPS ATTRDATES 
ATTREMT ATTREMTDIM ATTRGROUPS ATTRLABELCOMPS 
ATTRMAX ATTRMSK ATTRNAMES ATTRPER 
ATTRRHO ATTRSCALE ATTRSPLIT ATTRIITLE 
ATTRVALUES 

SATTRAVERAGE SATTRCOLS SATTRINDEX SATTRNODETAIL 
SATTRPAGE SATTRSTATE SATTRIOTALS SATTRTRANS 


For more information about these variables, see “MacicStore Global Variables”. 


If a function LOG is stored in the directory component, it is executed whenever the file is selected. 


Component 4—Code Component 

Component 4 contains a package with the variable APTRCODES. This is a character matrix of the file’s 
codes. 

Components 5-30—Label Components 


Components 3-30 are label components, pointed to by global variable ATTRLABELCOMPS. Each label 
component contains a character matrix of shape 500 n, where n is the length of the longest label. 
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Components 31 to End—Data Components 


Components 31 to the end of the file are data components. A data component is either an integer array 

or a package. It is a package if more than thirty percent of the values are 0. A data package comprises 

two variables, MSK and DATA: 

o MSK is a boolean array (of the same rank as the file) that indicates the shape of data, and which 
of it is nonzero; 

o DATA is a vector of the nonzero numbers. 


DATA contains some zeros because MacicSrore allows a data sparseness of 30, 40, 50, 60, 70, 80, 
or 90%. In other words, data is padded with “unnecessary” zeros. This means that the MacicStorE 
file components change size occasionally, and not every time an update is performed. MacicStore files 
which are updated daily will seldom experience “growing replace” expansion of file components. 


If the data is less than 30% sparse, DATA is full APL array. 


94 Appendix A: MAGICSTORE FILE ORGANIZATION 


Appendix B 


MAGICSTORE GLOBAL VARIABLES 


Type: 
b 
ch 
cl 
f 
i 
P 


boolean 
character 
clotted 
floating-point 
integer 
package 


Rank and shape: 


a 
d 


number of attributes in the file 
number of dimensions in the file 


m narbitrary values 


Variable Type Rank Shape 
APL b o 10 
ATTRALPHABET ch 1 41 
ATTRCALC i T n 
ATTRCALCDIM i 1 1 


Description 


APL flag 


Used to encode and decode attribute 
codes. 


AUTOCALC vector; length n equal to 
length of AUTOCALC dimension. Each ele- 
ment indicates the automatic calculation 
to be performed on the corresponding at- 
tribute: 


Value Calculation 


TOTALS 
AVERAGES 
LASTVALUE 
FIRSTVALUE 
MINIMUM 
MAXIMUM 
DAILYAVERAGE 


WOME WNR 


AUTOCALC dimension. 
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Variable 


ATTRCOMPS 


ATTRDATES 


ATTRDAYSOFWEEK 


ATTREMT 


ATTREMTDIM 


i 


i 


i 


Description 


Component index for date groups. Each 
column corresponds to a date group (as 
given in ATTRGROUPS; for example, if a 
period is in date group 3, then the data 
for that period is stored in a compo- 
nent listed in the third column of 
ATTRCOMPS. Each row of ATTRCOMPS 
represents a non-DATE partitioning. For 
example, if the file is partitioned on 
COUNTRY and PRODUCT, with blocking 
factors of 3 and 2 respectively, there 
would be COUNTRY partitions of: 
UNITED STATES, UNITED KINGDOM, 
GERMANY, CANADA, and AUSTRALIA, 
and PRODUCT partitions PALE ALE, 
REAL ALE,and LAGER, STOUT. There 
would therefore be four (2x2) non- 
DATE partitions, and ATTRCOMPS would 
have four rows. If COUNTRY were 
partitioned by 1 instead of 5, then 
ATTRCOMPS would have ten rows. 


Dates of periods stored; length n is the 
number of stored periods. [Dates are giv- 
en in MactcStore’s “canonical” format. 
For example, in a yearly file, 1983 is 
given as 1983; in a semiannual, quarter- 
ly, monthly, or general file, the second 
period of 1983 is given as 198302; in a 
weekly or daily file, February 7, 1983, 
is given as 19830207; and, in an OTHER- 
frequency file, the third period is given 
as 3.] 


Days of week covered by this file; n is 
the number of days. Each element may 
be 1 for Monday, 2 for Tuesday, etc. If 
the file is neither daily nor weekly, this 
vector has length 0. 


“Format specification vector”; length n is 
the number of attributes in the format- 
ting dimension, or 1, if every atiribute 
has the same format. Each element is in 
the form w.d, where w is the minimum 
column width, and d the number of deci- 
mal places. For example, 7.1 8.2 7 7 
22. 


Formatting dimension. 
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Variable 
ATTRGROUPS 


ATTRLABELCOMP 


ATTRMSK 


ATTRNAMES 


ATTRPER 


ATTRRHO 


ATTRSCALE 


ATTRSPLIT 


ATTRIITLE 


ATTRVALUES 


Type 


i 


ch 


ch 


Rank 


Shape 


Description 

Relates periods to date groups; length 
n is the number of stored periods. A date 
group comprises periods stored together 
in a data component. For example, if 
twenty periods are stored four periods 
per component, ATTRGROUPS would be: 
1122223333444 455 
5 5. 


Components of the file where labels are 
stored. 


Attribute mask; length n is the number 
of attributes in the file. Each element of 
ATTRMSK indicates if the corresponding 
attribute is to be kept or restored (1) or 
to be deleted (0). 


Dimension names; row length n is the 
length of the longest dimension name 
Rows are right-padded with blanks. 


Frequency; specifically, the number of 
periods per year. Value 0 for OTHER-fre- 
quency files. 


Number of attributes in each dimension. 


Scale. 


Blocking factors. Value 0 if correspond- 
ing dimension not partitioning dimen- 
sion. 


Title. Row 2 contains the = ‘road’ char- 
acters that underscore the title. 


Attribute codes; elements are encoded 
with ATTRALPHABET as the encoding 
string. 
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Variable Type Rank Shape Description 


ASK i 1 20 ASK state: 
[ 1] *BUFFER 
[ 2] *CLEAR 
[ 3] *MACRO 
[ 4] *EMPTY 
[ 5] text mode 
[ 6] macroinput counter since last JJ 
E 7]  macroinput limit between Ms 


[10] message file tie number 
[11] macro file tie number 


ASKBUP ch 1 n Input buffer 
ASKMAC p Input macros. 
KSE, ch 1 n Input buffer delimiters. 

ASKSUF ch 1 n Prompt suffix. 

DATA i d Data; arbitrary shape. 

EILE ch 4 22 Identifier of selected MacicStore file. 

ELIE i 0 10 File tie number of selected MacicSTore 
file. 

ETIME i (o 10 Session signon time. 

PEILE ch 1 22 File identifier of MacicStore program 
file. 

PG i 1 3 Page depth: 


[1] line counter 
[3J lines per page 


PTIE i o 10 MacicSrore program file tie number. 
SATTRAVERAGE i 1 n Dimensions specified to AVERAGE. 
SATTRCOLS i 1 n Dimensions specified to COLS. 
SATTRDATES i 1 n Selected periods. 

SATTREMT f 1 n 
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Variable 


SATTRINDEX 
SATTRLABELS 
SATTRNODETAIL 
SATTRNOS 
SATTRPAGE 
SATTRROWS 


SATTRSTATE 


SATTRTOTALS 
SATTRTRANS 
WIZDIR 


ZERO 


Type 


Rank Shape 


9 d-1 
2 mn 
1 n 
1 d 
1 n 
1 n 
1 10 
1 n 
4 d 
0 10 
o 10 


Description 


Attribute indices. 


Dimensions specified to NODETAIL. 


Dimensions specified to PAGES. 


Dimensions specified to ROWS. 


MacicStore state: 


mman 


C 


1) 
2] 
3] 
4J 
5J 
6] 


9] 


[10] 


file selected 

pseudocodes added 

periods selected 

UPDATE set 

LABELS set 

SATTRLABELS generation sup- 
pressed in caption 

DATA in workspace 

NODETAIL information sup- 
pressed 


Dimensions specified to TOTAL. 


Dimension order. 


ZERO flag, 
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Appendix C 


MAGICSTORE EVENTS 


Event Issuing 
number function Meaning 
561 TS Invalid code 
THE 
562 PSEUDOCODE Invalid dimension 
599 EXIT or QUIT reply to any prompt 
600 FILE File identifier is ill formed; you do not have access to the file; the file is 
not a MacicSrorr. file 
601 SET Dimension name is invalid; you specified more than one dimension 
602 SET Invalid attribute specification 
604 PUTDATA Pseudocodes have been created 
606 PUTDATA DATA not integer 
607 PUTDATA DATA has wrong shape 
608 PERIOD Invalid period specification 
609 LIS? Listing too wide for current setting of WIDTH; listing will have to be 
reformatted or page width reset 
610 FILE File doesn’t exist 
612 Periods not selected 
631 AVERAGE Invalid dimension 
632 NODETAIL Invalid dimension 
633 TOTAL Invalid dimension 
634 ORDER Invalid dimension 
641 PAGE Invalid dimension 
642 ROWS Invalid dimension 
643 COLS Invalid dimension 
649 EDITDATA No data to edit 
651 GETCODES Invalid code index 
PUTCODES 
863 OUTFILE Invalid file name 


MacicStore resizes files when you are adding data, changing the file directory, or putting listings 
to file. If MacicStore cannot resize the file because you have exhausted your file reservation, a 
message is displayed at the terminal: 


FILE RESERVATION ERROR- 
MESSAGE OPERATOR TO INCREASE FILE RESERVATION ... THEN TYPE +GO 
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Appendix D 


MAGICSTORE TIE NUMBERS 
a a ee 


File tie File 


number identifier File description 

99 Output file for LIST and LISTDATA 
24487 88 WIZHELP3 MacicStore help message file 
24488 88 WIZFNS3 MacicStore program file 


Each MacicStore data file that you select is tied to the lowest tie number greater than or equal to 
24489. Thus, usually, the data files you selected first, second, and third would be tied to 24489, 24490, 
and 24491. However, these tie numbers are not reserved. 
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Appendix E 


MAGICSTORE FUNCTIONS 


indicates that EDI? is to display significant data before it is overwritten 


APL 
indicates that you're using an APL terminal, and therefore want APL symbols; specifically, sets 
variable APE to | (the default value). 


AVERAGE dimensions 
specifies that the averages of dimensions are to be calculated and displayed in listings. 


CODES 
indicates that codes are used for editing and listing headings and prompts. Opposed to LABELS (the 
default setting). 


COLS dimensions 
specifies that dimensions are to form the listing's columns. 


DEPTH n 
specifies that the page depth (that is, the number of lines on a page for your terminal) is 
10 be n. 


datatcodesl DIVIDED codes2 
divides data for codes1 by data for codes2. DATA must be in the active workspace. 


DIRECTORY 
displays parameters of the selected MactcSrore file. 


prompts you for input to the current file. for the selected periods. 


l TA 
edits DATA variable in the workspace. DATA is read into the workspace by GETDATA and the edited 
version can be stored on file using PUTDATA. EDIT is equivalent to: 


GETLATA © EDITDATA © PUTDATA 


s from the active workspace, except for 
and LI 


1 global MaceSrorr obje 


fileid 
selects the identified MacicNrore file. For example: 
FILE *SALES* 


or 
FILE '1234567 SALES* 
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codes+GETCODES codenos 
reads codes into the active workspace. For example: 


A+GETCODES 12345 


would assign to variable A the first five codes of the file, in the form of a character matrix. The 
code numbers start at 1 for the first attribute of the first dimension and go up to the total number 
of all codes on the file. The first code in the second dimension is one higher than the last code 
in the first dimension. Compare GETCODES with PUTCODES. 


DATA 
reads data Irom a file into global variable DATA; uses the currently selected file, and periods, and 
the current settings of the ORDER and SET commands. 


labels+GETLABELS codenos 
reads labels Irom a file and assigns them to an APL variable. For example: 


LeGETLABELS 6 7 8 


assigns lo variable £ a character matrix of the labels for the sixth, seventh, and eighth attributes 
(PALE ALE, LAGER, and STOUT in the Frothy Beer Company's SALES file). The label code num- 


bers follow the same rules as code numbers; see the description of GETCODES 


GETMAGICSTORR 
reads MagicSvore functions and variables from file to the active workspace. (‘This function is 
executed automatically when you load workspace 39 MAGICSTORE.) 


codes /S data 
assigns data to codes. DATA must be in the active workspace. 


LABELS 
specifies that labels are used in EDIT and LIST headings and prompts. See also CODES, which is 
the alternative state setting. 


LINK 'fileid' 
ereates a M access function for the MacicStore file fileid. It bears the same name as the 
file it accesses. If you save this function along with MacicSrorr in a workspace, you can use it 
without first invoking LIWK or GETMAGICSTORE. 


T 
lists data; equivalent to GETDATA © LISTDATA. 


‘DATA 
lists data in the active workspace. Appends data to any file tied to 99 


data+codesl MINUS codes2 
subtracts data for codes2 from data for codes1. DATA must be in the active workspace. 


WOAPL 


indicates that the terminal you’re using has no APL symbols. In particular, it causes LIST to 
substitute some characters in listings; for example, / for |. 
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NODETAIL dimensions 
suppresses details for the specified dimensions; that is, causes listings to include only totals or 
averages for those dimensions. If you’ve issued neither the TOTAL nor the AVERAGE command for 
a dimension for which you’ve issued NODETAIL, that dimension’s total onty is listed. 


NOZERO 
indicates that zeros are to be treated as nonsignificant: they’re not printed in listings; they’re not 
included in averages; and they’re not displayed before they’re overwritten. This command is in effect 
when you get MacicStore. 


ORDER dimensions 
reorders the data according to dimensions. You needn’t specify every dimension to ORDER: the 
dimensions you do specify are moved to the end of the dimension order, in the sequence you specify. 
For example, if there are three non-DATE dimensions, the default ORDER state is 4 1 2 3. If you 
enter ORDER 2 1, the new dimension order is 3 4 2 1. 


OUTFILE 'fileid' 
creates (if necessary) fileid and ties it to 99. All output from LIST is appended to the file tied 
to 99. You would probably issue this command to create a file you’ll later process with the 
HSPRINF facility. 


PAGES dimensions 
puts dimensions at the head of each page. The order of dimensions affects the listing; the first 
is the outermost dimension. 


PAGESET 
is executed when you issue the LIST command. 


Normally, before a listing is displayed at your terminal, the print head {or cursor) twitches, and 
MacicSrore waits for you to align the paper on your terminal at the start of a new page, and 
then press RETURN. If you wish to print another message, or send special control characters to the 
terminal, define the function PAGESET. For example: 


V PAGESET;A 

[1] a SETS TOP OF FORM ON MOST ASCII TERMINALS 

[2] 'ALIGN PAPER AND HIT RETURN' © A+,0 © DARBOUT 27 102 
y 


PAGETHROW 
is executed when a listing skips to a new page. 


LIST keeps track of the number of lines it has printed on a page. To skip to a new page 
LIST spaces up as many lines as there are remaining on the current page. Many terminals will 
formfeed when given a special control message. This is much faster than the default method. By 
defining a function named PAGETHROW, you can specify your own mechanism to formfeed, which 
LIST will use instead of the default method. For example: 


V PAGETHROW 
[1] (OARBOUT 12 
v 


This function advances the paper to the start of the next page on most ASCH terminals. 
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PERIOD periods 
selects periods to be processed. The selected periods must be consistent with the data frequency 
when the file was created. For more information, see “Specifying Periods”. 


datatcodesl PLUS codes2 
adds data for codes to data for codes2. DAPA must be in the active workspace. 


dim PSEUDOCODE codes 
adds pseudocodes to dimension dim. 


codenos PUTCODES codes 
stores codes from an APL variable on file. For example: 


10 11 PUFCODES 2 8 p'DRAUGHT BOTTLED ' 
overwrites the 10th and 11th codes on file. 
PUTGATA 
stores the contents of global variable DATA on a file. Uses the current settings of the PILE, 


PERIOD, ORDER, and SET commands. 


codenos PUTLABELS labels 
stores labels on file from an APL variable. For example: 


10 11 PUTLABELS 2 12 p'DRAUGHT BEERBOTTLED BEER' 
overwrites the lOth and llth labels on file. 

dim REFMT w.d w.d w.d 

specifies a new format vector for dimension dim; effective until file reselected. In each element of 


the format specification vector, w is the width of the column for the corresponding attribute; and 
d is the number of decimal places to be allowed the attribute. 


codes RELABEL labels 
applies new labels to codes until file is reselected. 


RESTART 
restarts MacicSrorr; reties the relevant MacicStorr. files; and returns to the current line of the 
most recently suspended function. Used after any event that interrupts your terminal session. For 
example: 


+RESTART 


ROWS dimensions 
indicates that the specified dimensions are to form the rows of listings, that is, are to be displayed 
down the page. ‘Ihe dimensions appear in the order you specified them. 


dimension SET codes 
selects the attribute codes within dimension to be read from the file, and specifies the sequence 
in which they are to be read. This command affects the EDIT, GETDATA, LIST, and PUTDATA 
commands. You needn't specify dimension if MacicStorr can infer it from the codes 
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STATE 
displays the settings of the AVERAGE, AMEND, UPDATE, COLS, DEPTH, FILE, NODETAIL, ORDER, 
PAGES, PERIOD, ROWS, SET, TOTAL, WIDTH, ZERO, NOZERO, LABELS, and CODES commands. 


SUBSET codes 
reduces DATA and resequences attributes. 


datat+dim SUM codes 
adds data for codes along dim. DATA must be in the active workspace. 


data+THE codes 
returns data for codes. DATA must be in the active workspace. 


data+codesl TIMES codes2 
multiplies data for eodes1 by data for codes2. DATA must be in the active workspace. 


TITLE text 
specifies title to be used for listings until file is reselected. 


TOTAL dimensions 
calculates and displays in file listings the totals of the specified dimensions. 


UPDATE 
indicates that when you issue the EDIT command you will be entering new data. If UPDATE is set, 
MacicStore does not display old data before it’s overwritten; however, if when you issue EDIT 
MacicStore senses that significant data will be overwritten, it asks you if you want to proceed. 


WIDTH characters 
informs MacicStore that listings are to be formatted as characters wide. 


WIZARD 
invokes MacicStore in the conversational mode. It has these options: 


ACCESS 
ALTER 
AMEND 
CREATE 
DELETE 
DIRECTORY 
ERASE 
FILE 

LIST 
UPDATE 


ZERO 


indicates that zeros are significant: they're printed in reports; counted in averages; and signalled 
or displayed before they’re overwritten. 


106 Appendix E: MAGICSTORE FUNCTIONS 


INDEX 


Bold page numbers indicate principal entries. 


Alphabetization: Blanks precede nonblanks; capital letters precede lowercase letters. SHARP APL 
system commands are sorted as if they weren’t preceded by ). 


Some APL characters can be used in APL identifiers; these characters are sorted in this sequence: A 
BCDEFGHIJKLMNOPQRSTUVWXYZAABCDEEGHIZKLM 
NOPQG@RSTUVWXY2Z601234567829. 


APL characters that can’t be used in APL identifiers are sequenced as if they were speit out as their 
canonical names. the following list shows all such SHARP APL characters that appear in this index 
with their canonical names: 


> arrow, right è pawn 
- bar O quad 
: colon ? query 


+ cross © quote-quad 
x lazy cross * star 
) parenthesis, right 


A RESTART (expression), 22 
ASCII: character set, 72; terminals, 104 
ACCESS (option), 22, 28, 56 ASK (subprogram), 22, 28, 29, 30, 31, 32, 98 
accessing MAGICSTORE, 2 ASKMACRO (file), 22, 31 
access to file, 28, 56, 100 attributes, 3, 18, 46, 47; adding, 48; deleting 
active workspace, 22, 23 or restoring, 54 f., 97; specifying, 27, 33 f. 
AD (suboption of ALTER), 48 attribute codes. See codes 
adding attributes, 48 attribute indices, 18, 27, 99 
Airs, Peter, ii attribute labels. See labels 
ALL (keyword), 60 attribute mask, 97 
ALL (suboption of EIST), 41 attribute numbers, 27, 70, 71 
ALE (utility function), 80 AUSTRALIA (attribute), 3 
ALTER (option), 17, 24, 27, 28, 34, 47-55 AUTOCALC (Macie state setting function), 49, 
AMEND (option), 28, 37 f., 79 74, 95 
AMEND (state setting function), 27, 58, 62-64, AUTOLABEL (Macic state setting function), 
102 73, 74, 75, 76 
amending file, 21, 28, 37, 38, 39, 40, 58, 59, automatic calculations, 46, 74, 95; changing, 
62, 63, 64, 79 49 f. 
answering ahead, 30 AVERAGE (state setting function), 8, 58, 66 f., 
AP (suboption of ALTER), 24, 49 68, 98 100, 102, 104 
APL (state setting function), 72, 95, 102 AVERAGE (suboption of LIST), 41, 43 
APL. See SHARP APL AVERAGES (automatic calculation), 49, 74, 95 
arbitrary selection of data, 18 averages in listing, 9, 27, 102 
> ‘arrow, right’, 21, 38, 40, 63 A1, A2, A3, etc. (default codes), 83 
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B 


- ‘bar’ (in Macıc access), 76 
BACKSPACE (character), 32 

blanks, 23 

blocking factors, 55, 85, 88, 96, 97 
BOTTLES (attribute), 3 

buffered input, 29, 30 

business graphics. See SUPERPLOT 
BY (utility function), 80 


c 


CA (suboption of ALTER), 49 f. 

calculations on data, 15, 27; automatic, 46, 
49 f., 74, 85; in Maaic access, 76 f. 

CANADA (attribute), 3 

CANS (attribute), 3 

CC (suboption of ALTER), 34, 50 

CD (suboption of ALTER), 27, 50 

century part of year, omitting, 24 

CF (suboption of ALTER), 51 f. 

changing attribute codes, 50 

changing attribute labels, 52 

changing automatic calculations, 49 f. 

changing dimension names, 50 f. 

changing format, 51 f. 

changing frequency, 53 

changing name, 53 

changing parameters of file, 47-55 

changing scale, 51, 53 f. 

changing title, 54 

character charges, 80 

character sets, 72 

CL (suboption of ALTER), 52 

CLEAR (Macic command), 73, 75, 77 

CN (suboption of ALTER), 53, 55 

CODES (state setting function), 13, 14, 18, 58, 
61 f., 102, 103, 106 

codes, 3, 13, 18, 27, 33 f., 47, 61 f., 73, 97, 
100, 102; changing, 50; defining by ma- 
trix, 34, 83 

code component, 86, 93 

: ‘colon’ (in Macic access), 76 

COLS (state setting function), 4, 6, 7, 9, 12, 
15, 58, 61, 63, 64-66, 68, 100, 102, 106 

COLS (suboption of LIST), 41, 42, 44 

columns of listing, 4, 6, 19, 41, 42, 58, 64, 
102 

COLWIDTH (Macic state setting function), 75 

command mode. See nonconversational mode 

component index for date groups, 96 

components of file, 92 f. 
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compressing of data, 74 

concepts and features, 18-27, 79-84 
CONTINUE (workspace), 22 
conversational mode, 1, 28-57, 79, 106 
copying files, 55 

costs of accessing file, 87 

COUNTRY (dimension), 3 

Coyne, Nicola, ii 

CREATE {option), 16, 28, 32-37 
CREATEMACROFILE (utility function), 31 
creating a file, 16, 32-37 

+ ‘cross’ (in Magic access), 76 

CS (suboption of ALTER), 53 f. 

Cf (suboption of ALTER), 54 

currency exchange rate file (examples), 91 f. 


D 


DAILY (frequency), 25, 33 

DAILYAVERAGE (automatic calculation), 49, 
74, 95 

DATA (variable), 94 

DATA ALREADY EXISTS ON FILE (message), 
13 

data calculation utilities, 71 f. 

data components, 86, 93 

data entry aids, 21, 38, 63, 79 f. 

data entry. See editing file 

data package, 86 

data specification aids, Stars, 79 

DATE (dimension), 18, 27, 88 

DATED (Macic state setting function), 73, 75, 
77 

date format, 96 

date groups, 96, 97 

days of week, 33, 96 

decimal places, number of. See scale 

decimal places, 11, 29 

DEFAULT (utility function), 83 

defining period labels, 49 

DEFLATED (utility function), 80 

DELETE (option), 28, 57 

deleting attributes, 54 f., 97 

deleting periods, 57 

DEPTH (state setting function), 58, 67, 68 f., 
102, 106 

diagram, schematic, of file, 4 

dimensions, 1, 18, 46, 100; specifying, 27, 33 
f 

dimension names, 2, 33 f., 47, 97; changing, 
50 f. 

dimension number, 27 

dimension order, 19, 38, 58, 75, 99, 104 


DIRECTORY (command), 102 

DIRECTORY (option), 28, 46 f. 

directory component, 86, 93 

directory of file, 28, 46 f., 74, 86, 93 

disconnection from timesharing service, effects 
of, 22 

DISPLAY (Macic command), 73, 75, 76, 77 

DIVIDED (utility function), 71, 102 

DL (suboption of ALTER), 54 f., 60 

DRAUGHT (attribute), 3 

driven mode. See conversational mode 

DSA (group), 79 


E 


EDI? (command), 12, 13, 58, 59, 60, 61, 
62-64, 79, 102, 103, 105 

EDITDATA (command); 59, 60, 61, 62-64, 
100, 102 

editing file, 12, 13, 21, 37-40, 62, 63, 64, 79 
f., 87; controlling current input line, 21; 
shorthand notations, 21 f. 

effects of disconnection from timesharing serv- 
ice, 22 

entering data. See editing file 

entries, shading of user, vi 

ERASE (option), 28, 55, 56 

ERASEMAGICSTORE (function), 2, 102 

erasing file, 55, 56 

errors. See events 

error messages, 21 

events, 21, 79, 100 

EXIT (ASK command), 29, 38, 39, 100 

expanding file, 35, 92 

expunging objects, 2, 102 

EXTEND (utility function), 80 

exchange rate file (examples), 91 f. 


F 


file, 1 

FILE (option), 28, 57 

FILE (prompt), 23 

FILE (state setting function), 4, 7, 9, 12, 13, 
15, 19, 23, 53, 58, 59, 60, 61, 62, 65, 68, 
69, 70, 81, 82, 83, 100, 102, 105 

file design, 21, 85-92 

FILE FULL (event), 80 

file identifier: of MacicStore file, 32; of 
program file, 98; of selected file, 98; 
SHARP APL, 32 

PILE RESERVATION ERROR (event), 100 
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file storage, minimizing cost, 86 

file tie number, 101; of input macro file, 98; 
of message file, 98, 101; of output file, 68, 
69, 101, 104; of program file, 98, 101; of 
selected file, 98, 101 

FILE UPDATED (message), 29 

FIRSTVALUE (automatic calculation), 49, 74, 
95 

formatting dimension, 51, 96 

format of file, 47, 51, 52 

format specification vector, 96 

format widths, 51, 96 

FORMFEED (character), 104 

frequency, 18, 24, 32 f., 47, 58, 74, 97; 
changing, 53 

FROM (utility function), 80 

Frothy Beer Company PLC, The, 3, 18 

functions, 102-06 


G 


GENERAL (frequency), 24, 26, 33 

GERMANY (attribute), 3 

GETCODES (utility function), 70 f., 83, 100, 
103 

GETDATA (command), 15, 58, 59, 60, 61, 63, 
64, 68, 69 f., 71, 81, 102, 103, 105 

GETLABELS (utility function), 70, 83, 103 

GETMAGICSTORE (command), 2, 22, 23, 102, 
103 

GETPROFILE (utility function), 23 

getting help, ii 

glimpse of MacicSrore, a, 3-17 

global variables, 93, 95-99 

GO (utility function), 100 

growing replace, 94 


H 


handling large amounts of data, 21 

headings in listing, 14 

hectolitres, 3 

HELP (ASK command), 21, 29 

help, getting, ii 

HIGHLIGHT (Maaic state setting function), 
75 

history (of MacicStore), ii 

hl, 3 

HSP (function), 69, 80, 81 

HSPRINT (facility), 22, 69, 80 f., 104 

HSPRINT (workspace). See 1 HSPRINT 
(workspace) 


I 


identification component, 86, 93 

identifier. See file identifier 

identifying an item, 23 

identifying file, 79, 93 

IN (utility function), 80 

incremental cost, 87 

INFLATED (utility function), 80 

input, buffered, 29, 30 

input buffer, 98 

input macros, 29, 30, 31, 98 

input utility language, 38 

integer, 86; DATA must be, 98 

inversions, 86 

IS (utility function), 15, 71, 100, 103 

ILP. Sharp Network, 1 

LP. Sharp: offices, 22, 69, 80; representative, 
ji, 21 


J 


jumping to prompt, 38, 40 


L 


LABEL (Macc state setting function), 77 

LABELS (state setting function), 14, 18, 58, 
61 f., 99, 102, 103, 106 

labels, 3, 14, 18, 27, 61 f., 76, 103; chang- 
ing, 53 

label components, 86, 93, 97 

LAGER (attribute), 3 

LASTVALUE (automatic calculation), 49, 74, 95 

x ‘lazy cross’ (in Macic access), 76 

LINEFEED (character), 32 

lines per page, 98 

line counter, 98 

line noise, 80 

LINK (Macıc command), 2, 53, 73, 77, 102, 
103 

LIST (command), 4, 6, 7, 8, 9, 12, 19, 58, 
59, 61, 62, 63, 64, 65, 66, 67 f., 80, 81, 
100, 103, 104, 105 

LIST (option), 28, 30, 40-46 

EISTDATA (command), 14, 15, 61, 62, 63, 
64, 66, 67 f., 71, 80, 103 

listing file, 22, 40-46, 80 f., 87, 100 

listing directory of file, 46 f. 

)LOAD (SHARP APL system command), 2, 
77 
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location {of MacicStore), 2 
LOG (object packed in file directory), 83, 84, 
93 


logging use of file, 22, 83 f., 93 


M 


macroinput, 29, 30 f., 98 

MAGIC (workspace). See 39 MAGIC (work- 
space) 

MAGICSTORE (workspace). See 39 
MAGICSTORE (workspace) 

MacicSvore, 1 f.; a glimpse of, 3-17; histo- 
ry, ii 

Maaic, 1, 2, 34, 73-78, 79 

Maitpox (SHARP APL Message Processing 
Facility), ii 

manipulating data with SHARP APL, 81 f. 

matrix definition of labels or codes, 34, 83 

MAXIMUM (automatic calculation), 49, 74, 95 

maximum number of decimal places. See 
scale 

MAX. NUMBER OF DECIMAL PLACES 
(prompt), 86 

message file, 98, 101 

MINIMUM (automatic calculation), 49, 74, 95 

MINUS (utility function), 71, 103 

MONTHLY (frequency), 25 

MQ (Maieox address; query group for 
MacicStore), ii 

MSK (variable), 94 

multi-user access to file. See access to file 


N 


name of file, 32, 47; changing, 53 

Network, I.P. Sharp, 1 

NEW DATABASE ... CREATED (message), 32 

NOAPL (state setting function), 72, 103 

NOAUTOCALC (Macic state setting function), 
74 

NODETAIL (state setting function), 8, 58, 66 
f., 68, 99, 100, 104 

NODETAIL (suboption of LIST), 41, 43 

nonconversational mode, 22, 58-72, 79 

nonnumeric period labels, 49 

nonzero data, 27 

NOTIMESERIES (Macic state setting func- 
tion), 75 

NOYEAREND (Maaic state setting function), 
73 


NOZERO (state setting function), 6, 7, 27, 38, 
58, 62, 63, 66, 67, 68, 104 

NO FURTHER HELP AVAILABLE (message), 
29 


o 


OF (utility function), 80 

optimizing accesses to file, 21 

ORDER (state setting function), 12, 13, 27, 38, 
59, 61, 62, 69, 70, 81, 82, 100, 103, 104, 
105, 106 

order of dimensions, 19, 38, 58, 75, 99, 104 

organization of file, 35 f., 55, 93 f. 

OTHER (frequency), 18, 24, 26, 96 

OUTFILE (state setting function), 67, 69, 80, 
81, 100, 101, 104 

output file, 67, 69, 80, 81, 100, 101, 104 

overhead cost, 87 

overriding AUTOLABEL, 76 

overwriting data, 102 


P 


PACKAGE (dimension), 3 

package, data, 86 

packages, 3 

PAGES (state setting function), 4, 9, 15, 58, 
Gl, 63, 64-66, 68, 100, 104, 106 

PAGES (suboption of LIST), 41, 42, 44 

PAGESET (utility function), 104 

pages of listing, 19 

PAGETHROW (utility function), 104 

page depth, 58, 67, 68, 98, 102, 106 

page width, 58, 67, 68, 80, 100, 106 

PALE ALE (attribute), 3 

parameters of file, 28, 74, 86, 93, 102; 
changing, 47-55; listing, 46 f. 

) ‘parenthesis, right’ (ASK command), 29 

partitioning file, 35, 58, 85, 86, 88, 96, 97 

‘pawn’ (ASK command), 29 

)PCOPY (SHARP APL system command), 2, 
23, 29, 69, 79, 81, 84 

PERIOD (state setting function), 4, 7, 9, 12, 
13, 58, 59, 61, 62, 65, 68, 69, 70, 79, 81, 
82, 100, 105, 106 

periodicity. See frequency 

PERIODS (Maaic state setting function), 73 

periods, 19, 46, 58, 88, 96, 97, 98, 99, 100; 
specifying, 24-26 

period type. See frequency 

PLOT (Macic command), 77 


1i1 


plotting, 77 f. 

PLUS (utility function), 15, 72, 105 

PR (suboption of ACCESS), 56 

PRICES (example file), 3 

printing. See listing file 

print width, 80 

PRODUCT (dimension), 3 

products, MacicStore with other time series 
1 

PROFILE (utility function), 23 

profile, 22 f., 31 

program file, 98, 101 

prompts, 1, 13 

prompt mode. See conversational mode 

prompt numbers, 38 

PSEUDOCODE (utility function), 72, 100, 105 

pseudocodes, 15, 71, 99 

PUT (Macic command), 73 

PUTCODES (utility function), 70 f., 83, 100, 
103, 105 

PUTDATA (command), 58, 59, 60, 61, 63, 64, 
69 f., 71, 82, 100, 102 105 

PUTLABELS (utility function), 70 f., 83, 105 

PW (suboption of ACCESS), 56 


Q 


O ‘quad’ (ASK command), 29 

QAPPEND (SHARP APL system function), 83 

QARBOUT (SHARP APL system function), 
104 

OCREATE (SHARP APL system function), 83 

OLX (SHARP APL system variable), 23 

ONUMS (SHARP APL system function), 83 

ORDCI (SHARP APL system function), 84 

DREAD (SHARP APL system function), 79 

DOSTAC (SHARP APL system function), 22 
83 

OSTIE (SHARP APL system function), 79 
83 84 

OUNTIE (SHARP APL system function), 83 

QUARTERLY (frequency), 26 

? ‘query’ (ASK command), 29 

questions. See prompts 

QUIT (ASK command), 29, 100 

D ‘quote-quad’ (ASK command), 29 


R 


range of periods. See periods 
RB (suboption of ALTER), 55 
REAL ALE (attribute), 3 


reblocking a file, 47, 55 

reducing DATA, 72 

REFMT (utility function), 72, 105 

reformatting file, 51 f. 

RELABEL (utility function), 15, 72, 105 

remote printing. See HSPRINT (facility) 

renaming a file, 53, 55 

replacing default labels, 76 

reports. See listing file 

resequencing attributes. Sze setting attributes 

reselecting file, 57 

resizing file, 100 

RESTART (utility function), 22, 105 

restarting MacicStore, 22, 105 

restoring attributes, 54 f., 97 

RETURN (character), 32 

ROWS (state setting function), 4, 6, 7, 9, 12, 
15, 23, 58, 59, 61, 63, 64-66, 68, 100, 
105, 106 

ROWS (suboption of LIST), 41, 42, 44 

rows of listing, 4, 19 


S 


SALES (example file), 3 

)SAVE (SHARP APL system command), 31 

scale, 46, 47, 82, 86, 97; changing, 51, 53 fu; 
specifying, 35 

schematic diagram of file, 4 

SEMI (frequency), 26 

selecting file, 57 

session signon time, 98 

SET (state setting function), 12, 13, 15, 19, 
24, 34, 59 f., 61, 62, 68, 69, 70, 81, 82, 
100, 103, 105, 106 

SET (suboption of LIST), 41 f. 

SETPROFILE (utility function), 22, 23 

setting attributes, 19, 37, 58, 85 

setting top of form, 104 

SET WHICH DIMENSION (prompt), 42 

shading, of user entries in examples, vi 

shape of data, 93 

sharing access. See access to file 

Sharp, I.P. See LP. Sharp 

SHARP APL: character set, 21, 72, 102, 
103; evaluated input mode, emulation of, 
29, 38; knowledge of for MacicStore, 1; 
manipulating data with, 81 f. 

shortest unambiguous truncation, 6, 23 f., 27, 
28 

shorthand notations for input, 21 

significant data, 27, 38, 102, 104 


112 


size of file, 88 

skipping prompts, 63 

sparse data (storage method), 21, 86, 91, 92, 
94 

specifying attributes, 27 

specifying dimensions, 27 

specifying a file’s dimensions and attributes, 
33 ff. 

specifying a file’s frequency and title, 32 f. 

specifying a file’s organization, 35 f. 

specifying a file’s scale, 35 

specifying information to MacicSrore, 23-27 

specifying periods, 24-26 

specifying range of options, 22 

* ‘star’ (ASK command), 29, 31 

*BUFFER (ASK state segment), 31, 98 

*CLEAR (ASK state segment), 30, 31, 98 

*EMPTY (ASK state segment), 31, 98 

*MACRO (ASK state segment), 31, 98 

*NOBUFFER (ASK state segment), 31 

*NOCLEAR (ASK state segment), 31 

*NOEMPTY (ASK state segment), 31 

*NOMACRO (ASK state segment), 31 

*SUFFIX (ASK state segment), 32 

Srars data specification aids, 79 

STATE (command), 58, 68, 106 

state, 1, 7, 18, 58, 99; of ASK subprogram, 
Slits 

STOP (ASK command), 16, 30 

STOUT (attribute), 3 

structure of file, 21 

SUBSET (utility function), 72, 106 

SUM (utility function), 15, 72, 106 

Superptot, 1, 77 f. 

suppressing details, 104 


T 


terminal, non-APL, 21 

terminology, 18-20 

text mode, 98 

THE (utility function), 72, 100, 106 

THEN (utility function), 79, 80 

tie number. See file tie number 

TIME (function), 84 

timeframe, 24 

timepacking data, 1, 73 f. 

TIMES (utility function), 72, 80, 106 

TIMESERIES (Macc state setting function), 
73 

timestamp from file component control infor- 
mation, 84 


time series, 1 

time series products, MacicStore with other, 
1 

TITLE (utility function), 72, 75, 106 

title of file, 46, 47, 72, 75, 97, 106; chang- 
ing, 54; specifying, 32 f. 

TO (utility function), 25, 80 

TOTAL (state setting function), 7, 58, 59, 66 
f., 68, 100, 104, 106 

TOTAL (suboption of LIST), 41, 42, 44 

TOTALS (automatic calculation), 49, 58, 74, 
95 

totals in listing, 9, 27 

trapping events, 79 

truncation. See shortest unambiguous trunca- 
tion 

turnaround, 80 


U 


unambiguous truncation. See shortest unam- 
biguous truncation 

UNITED KINGDOM (attribute), 3 

UNITED STATES (attribute), 3 

UPDATE (option), 28, 37-39, 79 

UPDATE (state setting function), 58, 62-64, 
99, 106 

updating file, 21, 59; from non-Magicstore 
files, 82 

US (suboption of ACCESS), 56 

usage of file, 87 

users (of MacicStore), 1 

user entries, shading of, vi 

user number, 84 

Using the 1P. Sharp System: A Handbook 
for Nonprogrammers, 21 


v 


validating input, 15, 16, 38, 69 
value, data, 18 

variables, global, 93, 95-99 
very large numeric array, 86 


w 


WEEKLY (frequency), 25, 33 

WI (suboption of ACCESS), 56 

WIDTH (state setting function), 58, 67, 68 f., 
80, 100, 106 


113 


WIZARD (program), 16, 17, 21, 22, 24, 28, 
29, 30, 32, 43, 79, 80, 106 

WIZARD3 (identifying string), 79 

WIZARD, ii 

workspaces (for MacicStore), 2 

WRITEDIR (utility function), 83 

writing to the directory, 83 

)WSID (SHARP APL system command), 23, 
31 


Y 


YEARLY (frequency), 26 


Zz 


ZERO (state setting function), 4, 27, 58, 62, 
63, 66, 67, 68, 99 
zeros, 6, 27, 81, 94 


A 


ASUPERPLOT (Macic state setting function), 
77 


A 


APL (global variable), 95, 102 

ASK (global variable), 23, 31, 98 
ASKBUF (global variable), 98 

ASKMAC (package), 31, 98 

ASKSEP (global variable), 98 

ASKSUF (global variable), 98 
ATTRALPHABET (global variable), 95, 97 
ATTRCALCDIM (global variable), 95 
ATTRCOMPS (global variable), 96 
ATTRDATES (global variable), 96 
ATTRDAYSOFWEEK (global variable), 96 
ATTRFMT (global variable), 96 
ATTRGROUPS (global variable), 96 97 
ATTRLABELCOMP (global variable), 97 
ATTRMSK (global variable), 97 
ATTRNAMES (global variable), 97 
ATTRPER (global variable), 97 
ATTRRHO (global variable), 97 
ATTRSCALE (global variable), 70, 82, 97 
ATTRSPLIT (global variable), 97 
ATTRTITLE (global variable), 97 
ATTRVALUES (global variable), 97 
ATTR... (global variables), 93 


R 


DATA (global variable), 39, 63, 64, 68, 72, 
81, 82, 98, 99, 100, 102, 103, 105, 106 


£ 


FILE (global variable), 83, 98 
ETIE (global variable), 98 
ETIME (global variable), 98 


È 


PEILE (global variable), 98 
PG (global variable), 98 
PROFID (global variable), 23 
PTIE (global variable), 98 


8 


SATTRAVERAGE (global variable), 98 
SATTRCOLS (global variable), 98 
SATTRDATES (global variable), 98 
SATTRFEMT (global variable), 98 
SATTRINDEX (global variable), 99 
SATTRLABELS (global variable), 99 


114 


SATTRNODETAIL (global variable), 99 
SATTRPAGE (global variable), 99 
SATTRROWS (global variable, 99 
SATTRSTATE (global variable), 99 
SATTRIOTALS (global variable), 99 
SATTRIRANS (global variable), 99 
SATTR... (global variables), 93 


W 


WIZDIR (global variable), 99 


FA 


ZERO (global variable), 99 


123... 


1 FILEAID (workspace), 84 
1 HSPRINT (workspace), 81 
39 MAGIC (workspace), 2, 73, 77 


39 MAGICSTORE (workspace), 2, 22, 103 


88 WIZFNS3 (file). See program file 
88 WIZHELP3 (file). See message file 
588 STARSUTIL (workspace), 79 
777 PROFILE (workspace), 22 
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